SHARP 

COMPUTER 

SOFTWARE 








XC システムディスク 1(3.5”FD,5”FD> • 
XC システムディスク 2(3.5”FD,5”FD> • 
XC ライブラリディスク <3. 5”FD,5”FD> • 
C ユーザーズ マニュアル （ver2.0> • • • • 
C リファレンスマニュアル （ver2.0> •• • 
C ライブラリマニュアル VO し l(ver2.0) 
C ライブラリマニュアル VO L.2(ver2.0) 
ソース コード デバ ッ ガマニュアル （ver2.0> 

アセンブラマニュアル <ver2.0>. 

ブログラマーズマニュアル （ver2.0> • • • 

拡張マニュアル . 

登録カード . 


本マニュアルは rc compi 1 e r PR 0-68 K v e r 2.1 J で追加•変更され 
た機能についてまとめてあります。まず M 初に本書をお読みになつてから、「 C ユーザー 
ズマニュアル」をご覧ください。 

<ご注意> 

1. 本書の内容については万全を期して作成いたしましたが、万一ご不審な店や誤り 
記載もれなど、お気付きのことがありましたら、最寄りのシャープお客様ご相談 
窓口あるいはお買い求め販売店にご連絡ください。 

2. 運用した結果の影傅については、1項にかかわらず貴任をおいかねますのでご了承 
ください。 

3. 本害の内容に関しては、将来の予告なしに変更することがあります。 

4. 本書の内容の一部または全部を無断転載することは禁じられています。 

5. 付属の登録カードは必ず弊社までご返送ください。無登録の方は、一切のユーザー 
サボートが受けられませんので、ご注意ください。 

6. 本ソフトウエアを用いてソフト開発を行った商品を販売する場合の使用料（ロイア 
リティ）は無償ですが、マニュアルなどに本ソフトウェアを使用したことを明記く 
ださい。 


(弍じめ t 


このたびは 、 「C compiler PRO — 68 K ver 2. 1 J をお買い上げいただき、 
まことにありがとうございました。 

rc compiler PRO — 68 K ver 2. 1 J は 、 X 6 8 0 0 0 のために作られた総合 
開発ツールです。ご使用に際しては、必ず本説明害に記載されている操作方法•注意事項 
をよくお読みいただき、正しい操作によって有効に活用されるようお願い致します。 

※万一、ご不審な点•お気付きの点がありましたら、お買い求めの販売店、もしくは、も 
よりのシャーブお客様相談窓口にご連絡ください。 

商品構成は、下記の通りです。 


枚枚枚册冊冊冊冊冊冊冊枚 

11 11 1 11 lx lx 1A 11 1A 11 11 IX 

各各各 . 

















ご使用になる前に(インスト-ル) 


「C compiler PRO — 68 K v e r 2 .1 J では、次のような追加/変更がさ 
れています。 


1. FM 音源/ MIDI / ADPCM を同時に制御できる〇 PMDR V 3 • X を付属し 
ています。 

2. 直接 SCS I を制御できる SCS I ライブラリをサボートしています。 

3. 付属の浮動小数点•演算ドライバ ( FL 0 AT 2. X ) に対応した高速ライブラリをサポート 
しています。 

CC に / N f スイツチを指定することにより FLOAT ドライバに依存しない高速 
な実行ファイルが作成できます。 

( CC のスイツチについては、 「 C ユーザーズマニュアル」を参照してください） 

また、 rc ユーザーズマニュアル」のオートインスト-•ルが次のように変更されています。 
才 一 トインストール 


OPMDRV 3. X の追加にともない rc ユーザーズマニュアル J のオートインストール 
の手順 （ 1 • 4) に 〃 MUS I C ドライバ"の選択項目が追加されています。 


例）フロビーディスクの場合 


グラフィック RAM 
Basic 
B ASTOC 
M U S I C ドライバ 


RAM _ DISK として使用 
使用する 
使用する 
0 PMD R V 3 


* なお 、 v e r 2. 1ではビジュアルシェルは付厲していません 


標準では、今回追加された 0 PMDRV 3. X の環境がインストールされるよされるよう 
に設定されていますが、"する/しない"で"しない"を選択することによって 
OPMDRV 2. X の環境がインストールされます。 


OPMDRV 2. X 用の X — BASI C 用 外部関数 （「 C ユーザーズマニュアル」を参照）、 
ライブラリ （「 C ライブラリマニュアル1 J を参照）をご利用になる場合は、 0 p M DR V 
2. X の環境をインストールしてお使いください。 


なお、本番に記載の0 PMDRV 3. X 用のものと〇 PMDR V 2 • X 用のものを同時に 
利用することはできません。 
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第 1 章 ミュージック 


r C compiler PRO — 68K v e r 2 . 1」では新たに 
FM 音源 /M I D I /A D P CM を同時に コン トロールできる機能が追加 
されています。 

これにより、以下のファイルが追加/変更されています。 


フアイル名 

内 容 


MUSIC.DEF 

" ■ " ~ " 

FM 音源 （ M 丨 Dl / ADPCM 対応）用 DEF ファイル 

システム 2 の ¥BC 

MUSIC 3 .DEF 

FM 音源/ MIDI / ADPCM 用拡張 D E F ファイル 

システム 2 の ¥BC 

AUDIO.FNC 

AD P CM 外部関数 

システム 1の ¥ BASIC 2 

MUSIC.FNC 

FM 音源 （ MIDI / ADPCM 対応）用外部関数 

システム 1の ¥ BASIC 2 

MUSIC 3 .FNC 

FM 音源/ MIDI / ADPCM 用拡張外部関数 

システム 1の ¥ BASIC 2 

MUSIC . H 

FM 音源 （ MIDI / ADPCM 対応）用関数の定義 

システム 2の¥ INCLUDE 

MUSIC 3 .H 

FM 音源/ MIDI / ADPCM 用拡張関数の定義 

システム 2の¥ INCLUDE 

BASLIB.L 

BASTOC ライブラリ 

システム 2 の ¥ L 1 B 

IOCSCALL.MAC 

IOCS コールのへッダファイル 

システム 2の ¥1 NCLUDE 


これらのファイルを利用して作成したブログラムを動作させるためには、 
0PMDRV3. X が必要です。 

なお、従来の 0PMDRV2. X 用のファイルは、システムディスク 2 の 
MUSI C ディレクトリに入っています。 



新しいミュージックの機能を使用するためには、次のように CONFIG . SYS 、 BASIC . CNF を 
設定してください。 

なお、以下の設定をフッロビーディスクでは、オート.インストール （ INSTALL . BAT ) で 
自動的に行なえます。また、ハードディスクでは、オート•インストールで CONFIG.SYS 
の登録以外は自動的に行なえます。 （ C ユーザーズマニュアル参照） 


• CONFIG . SYS 

1 ) SYS ディレクトリに 0 PMDRV 3. X をコビーしてください。 

2 ) CONFIG . SYS に次のように 0 PMDRV 3. X を登録してください。 
I —— CONFIG . SYS の例--- 


FILES 


15 

BUFFERS 

= 

201024 

LASTDRIVE 


Z ： 

KEY 

= 

¥ KEY.SYS 

USKCG 

一 

¥ USKCG.SYS 

BELL 

mm 

¥ BEEP-SYS 

DEVICE 

= 

¥ SYS ¥ PRNDRV # SYS 

DEVICE 


¥ SYS ¥ ASK 68 K-SYS B ：¥ X 68 K . M-DIC B ：¥ X 68 K S.DIC ¥ ASK ¥ ENV 1 .ASK 

DEVICE 


¥ SYS ¥ FL 0 AT 2 .X " 

DEVICE 


¥ SYS ¥0 PMDRV 3 -X 1180 / P 64 /0 PM 

DEVICE 

= 

¥ SYS ¥ SCSIDRV.SYS /IDO 

DEVICE 

= 

¥ SYS ¥ RAMDISK.SYS #G 

DEVICE 

= 

¥ SYS ¥ HIST 0 RY.X / D ¥ HIS ¥ / SH 2,8,4 

DEVICE 


¥ SYS ¥ I 0 CS.X 

ENVSET 


512 ¥ STARTUP.ENV 

PROCESS 


5 2 20 


注） PCMDRV . SYS の機能は、 0 PMDRV 3. X に含まれていますので登録する必要はありません。 
• BASIC . CNF 

1 ) BASIC 2 ディレクトリに新しく追加/変更された 
AUDIO . FNC 、 MUSIC . FNC 、 MUSIC 3 .FNC 

をコビーしてください。 

2) BASIC . CNF に AUDIO 、 MUSIC 、 MUSIC 3 を追加定義してください。 


BASIC.CNF の例 


FREE 

— 

128 

WIDTH 

mm 

96 

BEEP 

: 

ON 

CAPS 

: 

OFF 

FUNC 


GRAPH 

FUNC 


MOUSE 

FUNC 


SPRITE 

FUNC 

• 

STICK 

FUNC 

= 

AUDIO 

FUNC 

二 

MUSIC 

FUNC 

二 

MUSIC 3 


1.2 _ 能説明 


0 PMDRV 3. 又では、 FM 音源/ MIDI / ADPCM を次のように同時にコン 
トロールできます。 

なお、 0 PMDRV 3. X は OPMDRV . X の上位互換になっていますが 、 OPM 
DRV 2. X とは互換性がありませんのでご注意ください。 

• 以下のデバイス名をサボートしています。 

PCM : P CM の録音/再生 

MIDI、OPM : MML データの再生、及び各コマンドの実行 

MID 1 A :アスキーファイルを MIDI コードに変換して MIDI OUT へ出力 

MIDIB :バイナリーファイルをそのまま MIDI データとして出力 

MIDIAE :アスキーエクスクルーシブデータファイルを MIDI コードに変換し 

て出力 (Musicstudio PR 0-68 K で作成される EXC ファイルなど） 

MIDIBE ••バイナリーエクスクルーシブデータファイルをそのまま MIDI デー 

夕として出力（ミ 1-1 で作成される EX B ファイルなど） 

注）エクスクルーシブデータを出力する場合のデバイス名は、 ’ M 1 DIAE ’ または 
’ MIDIBE ’ で行ってください。 

(， F 0’’ F 7, のチェックを行い、受信側がオーバーフローをおこさないように 
ウェイトを挿入します。） 

• FM 音源 / M I D I/ADP CM を任意のチャンネル（丨〜25> に割り当てて鳴らす事が 
できます。 

• ADPCM 音を12 8種類まで登録することができます。 

( MML 中では任意のノートに割り当てて記述できます。） 

• トラック数は80で、2 5トラックまで同時演奏することができます。 

參1トラックで和音を演奏することができます。 （ MIDI のみ） 

• モジュレーション/ビッチベンドのコマンドは、そのまま FM 音源に対しても機能 
します。 

• 常に M I D I クロック （ F 8> を出力しているので、外部シーケンサーを同期演奏させ 
ることができます。 

外部同期に設定すれば、外部シーケンサーでコントロールすることもできます。 

任意の小節でのスタート/ストッブが可能です。 

• SOUND PR 0-68 K の SND ファイルで音色設定ができます。 

(音色名もそのまま登録されます。） 

參 MML データの中にチャンネル変更コマンドを自由に設定できます。 

• MUSIC PR 0-68 K [ MIDI ] の MUS ファイルをそのまま演奏できます。 

(オプションスイッチ / Y を設定してください。） 


• 0 PMDRV 3. X 上で MUSIC PR 0-68 K . MUSIC PR 0-68 KCMIDI ] がそのまま利用できます。 
(オプションスイッチ / A を設定してください。） 




OPM ドライバ 3 (0 PMDRV 3. X ) では登録時に以下のオプションスイッチを 
設定できます。 


スイッチ 

内 容 

#n 

n にトラックバッファのサイズを1 K バイト単位で指定します。 

寧定範囲は 24 kn ••ィト〜 4096 k ハ••ィトで、省略した場合は6 4 K バイトを確保しま 


(例: 0 PMDRV 3 #120 ) 

/Pn 

n に PCM データのバッファサイズをドバイト単位で指定します。 

指定範囲は0いいィト〜4096いいィトで省略した場合は2 4 K バイトを確保します. 
ADPCM を使用しない場合は n に0を指定してください。 


(例： 0 PMDRV 3 / P 200 ) 

/Yn 

M | L ^ f 一夕の Y コマンドのモードを指定します。デフォルトは / Y 1 に設定され 


(例: 0 PMDRV 3 / Y 0 /MOP ) MUSIC PR 0-68 KCMIDI ] の MUS フパ》を演奏時の設定 

/OMP 

各音源に対するチャンネル番号を指定します。 

省略した場合は、 /0 PM の設定になります。 


(例： 0 PMDRV 3 /0 MP ) 


0=0 PM (使用チャンネル数8 : ch = 1〜8> 

M=MIDI (使用チャンネル数16 : ch =9 〜2 4) 

P=PCM (使用チャンネル数1: ch =2 5) 


アルファベットで指定された順に、各音源で使用するチャンネル番号を 
割り当てます。 

上記の場合は、 0 PM = ch 丨〜8 M 1 D い ch 9 〜24 PCM = ch 25 がそれぞれの音源 
に対するチャンネル番号となります。 


MIDI を使用しない場合は /0 PM と指定しておけば、従来の MML データ 
をそのまま演奏できます。 

(0 PM = chl 〜8 PCM = ch 9 MIDI = chlO 〜25> 


MIDI に指定された ch は、その範囲を MIDIchl 〜16にシフトして M 1 DI 0 UT 
に出力されます。’ / OPM •で chlO 〜25が指定されている場合は、 chlO が 
MIDIchl に、 ch 25 が MIDlchl 6 になります。 


これらの設定は、起動後にも変更することができます。 

( BASIC 上では ra . syschO コマンドで、0 S 上では （/0 MP ) などで変更） 




スイッチ 

内 容 

/Fn 

FM 音源全体の音程を微調整します。 h =0 〜63> テ••フ4卜は〇 

/R 

0 PMDRV 3. X を解除します。 

/A 1 

MUSIC PR 0-68 KCMIDI ] を使用する時に設定します。 


籲各スイッチを省略した場合のデフオルトは#6 4 /OPM / Y 1/ P 24 となります。 

• MU S ファイルを演奏する場合は次の様に指定してください。 

I— MI D I コントロールデータ出カモード 
DEVICE = ¥ SYS ¥0 PMDRV 3 .X 1120 /MOP / Y 0 


尚、それぞれの曲データの先頭に以下の〇 PM コマン ドを追加記入しておけば、 
上記の選択は不要になります 。 （OPM コマン ドを参照） 


0 PM ファイルを演奏する場合 （/0 PMX / Y 1〉 


MUS ファイルを演奏する場合 （/ M 0 P >(/ Y 0> 




1.4 拡 PML 書式 


0 PMDEV 3. X では次の MML が拡張されています。その他の MML につきましては、 
本体付属の 「X — BAS I C ユーザーズリファレンス」をご覽ください。 
(0 PMDRV 2. X で拡張された MML は使用できません。） 


MML データ 

意 味 

パラメータ範囲（初期値） 

@Nn 

チャンネル変更 


n=l 〜 25 

E3H 

パンポットの設定 


n =0( 右〉.. 127 (左〉 


ボリュームの設定 


n =0 〜 127 


ベロシティの設定 


n =0 〜 127 

QQIIH 

ダンパーオンオフの設定 


n =0( off ) 1 ( on ) 


ピッチベンドの設定 type 1 


n =0 〜 8192 〜 16383 (半音％ 683) 


ピッチベンドの設定 type 2 


nl =0 〜 127 (low byte ) 
n 2=0 〜 127 <hi byte ) 


モジュレーシヨンの設定 
n 2 を省略した場合は 198 
(speed は F M 音源のみに有効） 


nl =0 〜 127( depth > 
n 2=0 〜 255( speed ) 

p p 

和音の指定： M 初の音程のみ長さを指定可：異なる長さの音は混在不可。 

M 大8音 （><#-+ は設定可） 

( ドラムのパートなどを1トラックですますことができます。〉 

MIDI 以外のチャンネルでは和音演奏はできません。 

例 ， C 8 EG < C >， 


注） 

MUSIC PR 0-68 K [ MIDI ] の M U S ファイルを 演奏する場合は必ず、 （/ MOP >(/ YO > の 
モードで行ってください。 


m_alloc 関数 または （ M ) コマン ドで 確保す るメモリサイズは従来の 1 • 2 倍位に設定して 
ください。 


もし演奏がおかしくなる場合は、 m_trk 関数 実行後に m _ use / m _ f ree 関数で メモリ 使用 
状況を確認し、新たに設定しなおしてください。 






.5 サンプルプログラム 


100 /* 

110 /* music sample 

120 /* ，，おお、スザンナ！！，， S . C . Foster 
130 /* 

140 str tr , as , bs , cs , ds , part [255] 

150 /* 

160 init () 

170 m - sysch (”0 PM ”> 

180 ra . alloc (10,2000) 

190 m . assign (10,10) 

- > ? ”； tr 

> ?as 

- > ?，，；bs 

240 print 
250 /* 

260 m _ trkUO /’@ N ” + tr +”0”+ as +” o 4 v 9 q 7 116 t ，’+ bs > 

270 ■_ trk <10,” g&a b 8 く d 8 d 8 e 8> < d 8> b 8 g 8 .a b 8 b 8 a 8 g 8 a 4. ga &”> 

280 n _ trk <10,” b 8< d 8 d 8. e > < d 8> b 8 g 8. a & b 8 b 8 a 8 a 8 g 4. ga &”) 

290 B . trk (10, w b 8< d 8 d 8. e > < d 8> b 8 g 8 .a b 8 b 8 a 8 g 8 a 4 r 8 ga &”> 

300 m - trk (10，” b 8 く d 8 d 8 e 8> < d 8.> bg 8 .a bb 8. a 8 .a g 4 r 4”> 

310 m_trk (丨 0,” く c 4 c 4> < e 8 e 4 e 8> く d 8. d > b 8 g 8 a 4 r 8 ga &”> 

320 m _ trk (10,” b 8 く d 8 d 8. e > < d 8> b 8 g 8 a 8 b 8 b 8 a 8 .a g 4 r 8”） 

330 /* 

340 ra . play () 

350 while ( ra.statO <> 0) 

360 input ” 演奏を 終了しますか ( Y / N ) ? ”， cs 

370 if ((cs = " Y ") or (cs = ” y ”” then { 

380 m.stopO : end 

390 } else { 

400 ra.cont 0 

410 > 

420 endwhiIe 
430 end 


200 /* 

2101 input ”演奏チャンネルを指定してください 一 

220 I input ”音色番号を入力してください（1〜2 0 0)- 

230 I input ”テンポを入力してください （20 〜 3 0 0) — 







16 

24 

18 

44 

34 


能 


38 

38 

32 

32 

20 


トラックバッファの初期化 
旨定のトラックのトラックバッソァの確保 
指定チャンネルのトラック設定 
FM 音源の音色データ取得 
FM 音源の音色データを登録 
テンポ指定 

指定トラックに MML データをセット 
指定トラックバッファの残りバイト数を返す 
指定チャンネルの演奏開始 
指定チャンネルの演奏状態を返す 
指定チャンネルの演奏を一時停止 
指定チャンネルの演奏再開 
指定トラックバッファの使用容滑を返す 
データ出カチャンネルを一時変更 
指定チャンネルの音色番号設定 
指定チャンネルにボリユーム設定 
&定チャンネルのパンポット指定 
指定チャンネルのベロシティ設定 
指定チャンネルの音程シフト 
指定チャンネルへのオールノー トオフ出力 
MIDI 出力 

指定チャンネルへノー トオン出力 
指定チャンネルへノー トオフ出力 
MIDI の同期モードを設定 
曲の拍子設定 

SND ファイルのデータを FM 音源用に登録 

指定の音程に PCM 音を登録 

チャンネル番号の割り当て変更 

M I D I インターフェイスの有無チェック 

ドラィ V 起動時のトラパハの全 A ” ィト数を返す 

1 バイトデータを M I D I へ出力 

演奏中の小節番号を返す 

Y コマンドの解釈 

演奏開始ハ節の設定 

演奏停止ハ節の設定 

FM 音源のモジユレーシヨンの深さ設定 

外部入力音の PCM 録音 

登録されている P CM データの取得 

指定された PCM データのサイズを返す 

PCM の実行状態を返す 

指定された P CM データの再生 

指定チャンネルへの各種のオフ出力 

指定の 0 PM レジスタにデータをセット 

MIDI 制御レジスタにデータをセット 

FM 音源の音色名の登録 

FM 音源の音色名の取得 

PCM 音色名の登録 

PCM 音色名の取得 

マスターボリ ューム の設定 


20 

29 

26 

27 
25 

28 


.END 

. M 0 DSNS 

.PCMREC 

.PCMGET 

.PCMLEN 

.PCMBSY 

. PCM 0 N 

.CTRLRES 

.0 PMREG 

.MDREG 

.TNHSET 

.TNMGET 

•PNMSET 

.PNMGET 


36 
19 
33 
30 

37 


. NT 0 FF 

.SYNC 

.METER 

.SNDSET 

.PCMSET 

.SYSCH 

.IFCHK 

.FREEA 

.OUT 

.MEAS 

.YCOM 


33 

41 

24 

40 

39 

11 

14 

22 


TRNS 

.ANTOFF 

.DIROUT 


■STAT 

STOP 

.CONT 

.USE 

.CHAN 

.PROG 

„ V 0 L 

_PAN 



.ALLOC 

.ASSIGN 

.VGET 

.VSET 

.TEMPO 

TRK 

FREE 


番号 


• 6 X - BASIC -覧表 


0123456789 ABFOl 234589 BC019ABCF0 2345689 ABCDEF0123 
0000000000000 丨 111111 丨 112222222333333333333334444 









番号 


45 

46 

47 

48 

49 
4 A 
4 B 



M.BEND 
M MOD 
M OPMEXC 
M OPMLFQ 
M PGMFLT 
M VOLFLT 
M PANFLT 
M.ERRGET 
.MUTE 
PCMCLR 
_SOLO 


指定チャンネルのビッチベンド設定 
指定チャンネルのモジュレーシヨン設定 
FM 音源のパラメータセットの選択 
FM 音源の L F 0の発振周波数の設定 
MML 音色切り替えコマンドの出力選択 
MML ボリューム設定コマンドの出力選択 
MML パンポット設定コマンドの出力選択 
直前の MUSIC 関数のエラーコードを返す 
指定チャンネルの音を消音 
P CM バッファのクリア 
指定チャンネル以外の音を消音 













1.7 X - BASIC 醒リファレンス 


「C compiler PRO — 68 K v e r 2 .1 J では、 OPMDRV . X 用に 
用意された X — B A S I C 外部関数の上位互換な （F M 音源 / M I D I/A D P CM 
を同時に制御できる） OPMDRV 3. X 用の X — BAS I C 外部関数がサボートさ 
れています。 

この拡張された X — BAS I C 外部関数は X BASTO C などにより実行ファイルに 
コンパイルすることも可能です。このため、新しく次のファイルが v e r 2 • 1より 
追加/変更されています。 


ファイル名 

1 _ 1 ■ ■ - ■ - 

内 容 

MUSIC.DEF 

FM 音源 （. MID け ADPCM 対応）用 DEF ファイル 

HUSIC 3 .DEF 

FM 音源/ MIDI / ADPCM 用拡張 D E F ファイル 

AUDIO.FNC 

AD P CM 外部関数 

MUSIC.FNC 

FM 音源 （ MID け ADPCM 対応）用外部関数 

MUSIC 3. FNC 

FM 音源/ MID け ADPCM 用拡張外部関数 

MUSIC.H 

FM 音源 （ MIDI / ADPCM 対応）用関数の定義 

MUSIC 3 .H 

FM 音源/ MIDI / ADPCM 用拡張関数の定義 

BASLIB.L 

BAST 0 C ライブラリ 


なお 、 「C compiler PRO — 68 K v e r 2 . OJ でサボートされていた 
0 PMDRV 2. X 用の X — BASIC 外部関数とは互換性がありませんのでご注意 
ください。 


従来の 0 PMDKV 2 用のファイルは、システムディスク2の MUSIC ディレクト 
リに入つています。 「 C ユーザーズマニュアル J に記載の X — B A S I C 関数をご利 
用になる場合は、そのファイルをご使用ください。 

( OPMDHV 3. X 用の関数と同時に利用することはできません） 

従来 PCMDRV . SYS で サボー トされていた機能も〇 pmDR V 3 • X で包含し 
ていますので、この X — BASI C 関数リファレンスに記載されていない A D P C M 
用の X - B A S I C 外部関数 （ A _ PLAY 、 A _ REC ) も従来通りお使いいただけます。 
詳細は、本体付域の 「X — BAS I C ユーザーズリファレンス」を参吗してください。 
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M ALLOC 


MUSIC 



害 

式 


引 

数 


戻， 

) m 


機 

能 


m_a I loc ( ( t ] , s ) 
char ( t ), int ( s ) 
int 

指定されたトラック t のトラックバッファを確保します。 

t . トラック番号 （1 〜80> 

s . バッファサイズ （1 〜65536> 

全トラックバッファ内のデータはクリアされます。 

また、バッファサイズに1〜3を指定しても、 4 バイト確保します。 
t を省略すると全てのトラックをバッファサイズ S で確保します。 

なお、総トラックのバッファサイズ（それぞれのトラックに割り当て 
られているトラックバッファの総合計）は、 CONFIG . SYS フ 

ァイル内で指定してください。 

DEVICE = ¥ SYS ¥0 PMDRV 3 .X innn 
(nnn :総トラックバッファサイズ[単位： K B ]) 

戻り値として、正常のときは〇、エラーのときは-1を返します。 


M ANTOF F 


MUSIC 3 


■ 

者 

式 


引 

数 

戻 

り值 


機 

能 


ra _ antoff ( [ c )) 
char 


指定のチャンネル c へオールノー トオフを出力します。 
c . チャンネル番号 （1 〜 25) 

c が省略された場合、全てのチャンネルへオールノー トオフを出力しま 
す0 

戻り値として、正常のときは〇、エラーのときは-1を返します。 
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M A S S I GN 


MUSIC 


害 

式 


引 

数 


戻 

り值 


機 

能 


m _ assign(c [, t ]) 
char 

int 

指定のチャンネル c で使用するトラック t を設定します。 

c . チャンネル番号 U 〜25> 

t . トラック番号（丨〜80> 

また、 t が省略された場合は、チャンネル c に設定されているトラッ 
ク番号を返します。 

複数のチャンネルに同一のトラックを割りあてると、それぞれ同じ楽 
譜データを演奏します。また、複数のトラックを1つのチャンネルに 
割りあてると、最も新しく割りふられたトラックの楽譜データを演奏 
します。 

デフオルト値は、チャンネル1〜8が、それぞれトラック1〜8に対応 
します。 

戻り値として、正常のときは0、エラーのときは-1を返します。 


M BEND 


MUSIC 3 


害 

式 


引 

数 


戻» 

) 値 


機 

能 


m _ bend ( [c ] , b ) 


char 


指定のチヤンネルのビッチベンドを設定します。 


c . チャンネル番号 （1 〜25> 

b . ピッチベンドデータ （0 〜127〉 


c が省略された場合は、全てのチャンネルにビッチベンド b を設定しま 
す。 b は省略できません。 

戻り値として、正常のときは0、エラーのときは-1を返します。 
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M CHAN 


MUSIC 3 



m . chan(c 1[, c 2] > 
char 


int 

指定のチャンネルのデータ出カチャンネルを一時的に変更します。 

cl . チヤンネル番号 （1 〜 25) 

c 2. 出カチャンネル番号 （1 〜25> 

c 2 が省略された場合は、現在の設定値を返します。 
reassign 関数や MML データ @ N とは異なり、チャンネル変更前のパ 
ラメータ（トラック番号、音色番号、ボリュームなど）を引き継ぎます。 
関数実行まで有効です0 

戻り値として、正常のときは0、エラーのときは-1を返します。 



m in i t 


M CONT 


MUSIC 



式 


引 

数 


L 戻— 

り使 


機 

能 


m.cont ( ( cl ] し c 2〕 し c 3〕 し c 4] し c 5〕 し c 6〕 [, c 7 ] [, c 8]) 

char 

int 

cl から c 8 で指定されたチャンネルにおいて、一時停止した演奏を再開 
します。 

cl 〜 c 8. チャンネル番号 （ 1〜 25) 

cl から c 8 をすベて省略すると、現在一時停止しているすべてのチャンネ 
ルの演奏を再開します。 

戻り値として、正常のときは0、エラーのときは-1を返します。 



m—stop 
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M CTRLRES 


MUSIC 3 



m _ ctrlres ( [ c ]) 
char 


int 

指定のチャンネル c へビッチベンドオフ/モジユレーシヨンオフ/ 
ダンバーオフ/オールノー トオフを出力します。 
c . チャンネル番号 （1 〜25> 

c が省略された場合、全てのチャンネルへビッチベンドオフ/モジュレー 
シヨンオフ/ダンパーオフ/オールノー トオフを出力します。 

戻り値として、正常のときは0、エラーのときは-1を返します《 


M D I ROUT 


MUSIC 3 



式 


引 

数 


戻 

り值 


機 

— 

能 


m . dirout ( Ing , ca ) 


int ( Ing ), char 型一次元配列名 （ ca ) 
int 

Ing バイトの MI DI データを MI DI へ出力します。 

Ing . Ing のとりうる値は 1 から配列名 ca で宣言された配列の 

添字までです。 

ca . MIDI データを格納している char 型一次元配列名 
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M END 


MUSIC 3 


「書 

式 


引 

数 


戻 

り偵 


機 

能 



m _ end ( ra > 
int 

int 

演奏を停止する小節を設定します。 

m . 演奏を中止する小節番号 

全てのチャンネルの I ”などの位置が同じでないと正 
常な演奏ができません。 

戻り値として、正常のときは〇、エラーのときは-1を返します。 


m start 


M ERRGET 


MUSIC 3 


| 害 式 1 ra.errgetO 
1 戻り 镇 1 int 

機 能 j 直前の MU S I C 関数のエラーコードを返します。 

正常終了している場合は0を返し、エラーの場合は1〜65の 


エラーコードを返します。エラーコードについては、「1.1 
ーコード ー覧 J を参照してください。 


3エラ 
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FREE 


MUSIC 




free ⑴ 



char 



int 



指定のトラック t のトラックバッファの残りバイト数を返します 
t . トラック番号 （1 〜80> 


m . freea , m_use 


FREE A 


MUSIC 3 



freea () 



# ライパ起動時に確保したトラックバッファの全バイト数を返しま 


• free,mj 






M I FCHK 


MUSIC 3 



m _ ifchk () 
int 

M I D I インターフェイスの有無をチェックします。 

インターフェイスがつながっている場合は0、つながっていない場合 
は -1 を返します。 


M I N I T 


MUSIC 



式 


引 

数 


戻 

り偵 


機 

能」 


m — init ( md ) 


char ( md ) 


int 

トラックバッファを初期化します。各トラックバッファは4バイトに 
設定されます。 

また、各チャンネルのパラメータ（トラック番号、音色番号、ボリュー 
ムなど）も初期化されます。 

md に 1 を指定した場合、 FM 音源の音色データも初期化します。 
md に0設定または省略した場合は音色データは初期化しません。 

. md . 初期化モード 

〇 =トラックバッファの初期化 
1=トラックバッファ、音色データの初期化 
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M MDREG 


MUSIC 3 



式 


引 

数 


戻 

り值 


機 

能 


m . dreg ( gr , adr , dt ) 


char 


int 

MIDI 制御 I C ( YM 3802) のレジスタに値を害き込みます。 gr には 
グルーブナンバー、 adr にはアドレスナンバーを指定します。 dt にはレジ 
スタに書き込む値を〇〜255の範囲で指定します。 

戻り値として、正常のときは0、エラーのときは1を返します。 

注：間違ったパラメータを指定すると、システムが正常に動作しなくな 
る場合があります。 

YM 3802の機能を十分に理解の上でご使用ください。 


M ME A S 


MUSIC 3 


■ ■ 

害 

式 


「戻 

り値 


能！ 


m.measO 

int 

現在演奏中の小節番号を返します。 

MML データ”1:”，” D . S .” などのくり返し記号の場合はくり返し回 
数がそのまま加算されますので、実際の小節番号とは異なる場合があり 
ます。 



m _ end , m.siart 
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M METER 


HUSIC 3 


書 

式 


引 

数 


戻 

り值 


機 

能 


m . raeter ( n , d ) 
char 


int 


曲の拍子を設定します。 


n . 分子〜16〉 

d . 分母 (2, 4,8, 16) 


デフォルト値は4/4拍子に設定されています。 

戻り値として、正常のときは0、エラーのときは-1を返します。 


M MOD 


MUSIC 3 


害 

式 


引 

数 


戻 

り值 


機 

能 


m _ mod ( lc J 
char 


int 

指定のチャンネル c のモジュレーションを設定します。 


c . チャンネル番号 （1 〜25> 

m . モジ ュレー シヨン データ （0 〜 127〉 


c が省略された場合は、全てのチャンネルにモジュレーション ra を 
設定します。 m は省略できません。 

戻り値として、正常のときは0、エラーのときは-1を返します。 



m^modsns 
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M MOD SN S 


MUSIC 3 


書 

式 


引 

—数 


戻 

り值 

:« 

能 


m _ modsns ( [ m ]) 


char 


int 

FM 音源全体のモジユレーシヨンの深さを設定します。 

m . モジユレーシヨンの深さ <0〜127〉 

m が省略された場合は、現在の設定値を返します。 

戻り値として、正常のときは0、エラーのときは-1を返します。 



m.mod 


M MSTVOL 


MUSIC 3 


-: - 

式 


引 

数 


戻 卜 

) 倩 


機 

能 


m.mstvol( (vol )) 
char 


int 

マスターボリユームを設定します。 

vol . ボリ ユームデータ （0 〜127〉 

デフォルト値は127 

vol が省略された場合、現在の設定値を返します。 
nUn it 関数を実行するまで有効です。 

P CM のチャンネルに対しては無効です。 

戻り値として、正常のときは0、エラーのときは-1を返します。 
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M MUTE 


MUSIC3 



式 


引 

数 


戻 

り値 


m _ mute ( [ cl ] [， c 2] (, c 3] (, c 4 ) [, c 5 ] し c 6] (, c 7 ] し c 8] > 

char 

int 


m cl から c 8 で指定したチャンネルの音をミ ユー ト（消音）します。 

ノー ト以外のデータは常に出力されます。 

cl 〜 c 8. チャンネル番号 （1 〜25> 

cl から c 8 を省略するとミユートが解除されます。 

戻り値として、正常のときは〇、エラーのときは-1を返します。 



m solo 


M NTOF F 


MUSIC 3 


書式 m.ntof f ( c , nt (, vel ]) 


引 数 char 


戻 り 値 1 int 

m 能 ： 指定のチャンネルへノートオフを出力します。 


c . チヤンネル番号 （ 1〜25> 

nt . ノー ト番号 (0 〜127) 

vel . ベロシティデータ （0 〜127〉 


vel が省略された場合、ベロシティ値を6 4で出力します。 

戻り値として、正常のときは0、エラーのときは-1を返します。 



m—nton 
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M NTON 


MUSIC 3 



Lf— 

式 


引 

数 


戻 

り值 


機 

能 


■• nton ( c , nt , [vel ]) 


char 


int 


指定のチヤンネルへノー トオンを出力します。 


C . チヤンネル番号 （1 〜 25) 

nt . ノー ト番号 <0〜127〉 

ve !. ベロシティデータ （0 〜127〉 


vel が省略された場合、ベロシティ値を6 4で出力します。 

戻り値として、正常のときは0、エラーのときは-1を返します。 



ro^ntof f 


M OPMEXC 


MUSIC 3 



機 能 


m _ opmexc ( [rad ]) 


char 


int 

FM 音源にセットする音色パラメータの内、 LFQ / PMD/AMD 

などの全体に影釋する パラメータを 音色切り替え時に セッ トする かど 
うかを選択します。 

md . パラメータの設定スイツチ 

0=セットしない 

i = セットする （デフォルト値は n 
md が省略された場合、現在の状態を返します。 

戻り値として、正常のときは〇、エラーのときは •！ を返します。 


m_vset 
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M OPMLFQ 


MUSIC 3 



「害 

式 


引 

数 


戻 

り鑣 


機 

能 


m _ opmlfq ( [spd ]) 


char 


FM 音源の LFO の発振周波数（スピード）を設定します。 

spd . スビード （0 〜255、デフォルト値は198〉 

spd が省略された場合、現在のデータを返します。 

戻り値として、正常のときは〇、エラーのときは-1を返します。 


M OPMREG 


MUSIC 3 



« 能 


m . opmreg(reg [, data ] > 
char 


指定の 0 PM レジスタにデータをセツトします。 

reg . 0 PM レジスタ番号 （0 〜255) 

data . 0 PM へ害き込むデータ 

data が省略された場合、現在の reg で示す0 PM レジスタの内容を返しま 
す0 

一度も指定のレジスタが害き換えられていない場合は、一1を返します。 
戻り値として、正常なときは〇、エラーのときは-1を返します。 
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M OUT 


MUSIC 3 



書式 

m _ out ( data ) 



数 

char 




int 



m 能 

1 バイトデータを M I D I へ出力します。 


data . MIDI データ <0 〜 255) 

戻り値として、正常なときは0、エラーのときは -1 を返します。 



m _ d 1 rout 


M 


PAN 


MUSIC 3 




m . pan ( ( c ) [, pan ]) 


Lil 


戻卜 



■ ■ ■ 

能 


char 


指定のチヤンネル c にのパンボット pan を設定します。 


c . チヤンネル番号 <1〜25> 

Pan . パンボットデータ （0 〜127) 

デフォルト値は64 


〇 =ライト（右端) 


64 =センター（中央) 


127 =レフト（左端） 

c か省略された場合は、全てのチャンネルに pan を設定します。 
pan が省略された場合は、現在の設定値を返します。 

戻り値として、正常なときは0、エラーのときは-1を返します。 
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M PANFLT 


MUSIC 3 




戻り偵 


機 能 



m _ panflt ( (c ] し！ nd 〕 > 
char 


int 

MM L データの PAN の切り替えコマンド Pn を、演奏時に出力するか 

どうかを選択します。 

c . チャ ン ネル番号 （1 〜25> 

md .0 =Pn を出力する 

l=Pn を出力しない 

c が省略された場合は、全てのチャンネルに md を設定します。 
rad が省略された場合は、現在の設定値を返します。 

戻り値として、正常なときは〇、エラーのときは-1を返します。 


m_pgmf 丨 t 、 m _ voIf 11 


M PCMB S Y 


HUSIC 3 



m . pcmbsy () 


int 

PCM の実行状態を調べます。 


0 x 00 

0 x 02 

0 x 04 

0 x 12 

0 x 14 

0 x 22 

0 x 24 


何も実行していない 

出力中 （ ADPCMOUT , m - pcinon , a_play を実行中) 
入力中 ( ADPCMINP , m _ pcnrec , a„rec を実行中) 
出力中 （ ADPCMA 0 T を実行中） 

入力中 （ ADPCMAIN を実行中） 

出力中 （ ADPCML 0 T を実行中） 

入力中 （ ADPCML 1 N を実行中） 
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M PCMC LR 


MUSIC 3 



m.pcmc I r () 
int 

PCM バッファをクリアします。 

m - pcmset 関数などで登録した P C M データが失われます。 

戻り値として、正常なときは0、エラーのときは -1 を返します。 


M PCMGET 


MUSIC 3 




式 


引 

数 


戻 

り镇 



能 


m . pcmget ( nt , ca ) 


char < nt >， char 型一次元配列名 ( ca > 

int 


登録されている P CM データを ca に読み込みます。 
nt . ノー ト番号 

ca . P CM データバッファを格納するための char 型一次元 

_ 配列名 

戻り値として、正常なときは0、エラーのときは-1を返します。 



m . pcmlen , m.pcnset 
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PCMLEN 


MUSIC 3 


書 式 m _ pcmlen ( ( nt ]) 



[； 戻り值 1 


int 


機 能1ノー ト番号 nt に登録されている P CM データのサイズを返します。 

nt . ノー ト番号 (0 〜 127) 

nt を省略すると 、 P CM バッファの残り容量を返します。 

戻り値として、正常なときは〇、エラーのときは -1 を返します。 



m pcmset , ra.pcmget 
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M PCMON 


MUSIC 3 


害 

式 


引 

数 


戻 

り镇 


m 

能 


m _ pcmon(nt [, sf ] [, md ]) 


char 


int 

指定された PCM データを再生します。 

nt . ノー ト番号<0〜 127) 

sf . サンプリング周波数 

0 .3.9 KHz 

1 .5.2 KHZ 

2 .7.8 KHz 

3 .10.4 KHZ 

4 .15.6 KHZ 

音声を再生する場合、原則として n^pcmrec 関数で録音 
したときのサンプリング周波数 sf を使用してください。 
それ以外を使用すると、録音した音声を正常に再生で 
きません。 

md . 音声出カモード（オーディオ出力端子） 

0 . カット 

1 . 左 

2 . 右 

3 . ステレオ（左右両方） 

sf,md が省略された場合は sf =4 md =3 で再生します。 

戻り値として、正常なときは0、エラーのときは-1を返します。 



m ^ pcmrec , m.pcmset 
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M PCMREC 


MUSIC 3 



m - pcmrec ( sf , lng , ca ) 

char ( sf ), int ( Inghchar 型一次元配列名 （ ca > 
int 


機 ^ 外部入力音（オーディオ入力端子）を P CM 録音します。 

実行直後に入力待ちになり、約4秒以内に入力がなければ 
実行を中止します。 

sf . サンプリング周波数 

0 .3.9 KHz ( 1秒間に消费するメモリサイズ1950バイト） 

1 .5.2 KHz ( 1秒間に消費するメモリサイズ2600バイト） 

2 .7.8 KHz ( 1秒間に消齊するメモリサイズ3900バイト） 

3 .10.4 KHz < 1秒間に消？？するメモリサイズ5200バイト） 

4 .15.6 KHz ( 1秒問に消黄するメモリサイズ7800バイト) 

Ing . 録音する配列 ca の添字0からの長さ《最大=32767〉 

Ing のとりうる値は、1から、配列名 ca で宣言された配 
列の添字+1までです。 

ca . P CM を格納する char 型一次元配列名 

戻り値として、正常なときは〇、エラーのときは-1を返します。 



m pcmon , ra.pcroset 
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M PCMSET 


MUSIC 3 


害 

式 


引 

数 


;戻卜 

) 值 


«5 

能 


m . pcmset ( nt , sf , lng . ca ) 

char ( nt , sf ), int ( lng)，char 型一次元配列名 ( ca ) 
int 

指定の音程に PCM 音を登録します。 

指定できる音程は’02’ （0) から’ G #8’（ 127) までです。 

nt . ノー ト番号 (0 〜127〉 

sf . サンプリング周波数 

0 .3.9 KHz 

1 .5.2 KHz 

2 .7.8 KHz 

3 .10.4 KHZ 

4 .15.6 KHZ 

lng . 登録する配列 ca の添字0からの長さ （ M 大=32767) 

lng のとりうる値は、1から、配列名 ca で宣言された 
配列の添字+1までです。 

ca . P CM データが格納されている一次元配列名 

戻り値として、正常なときは0、エラーのときは-1を返します。 


岭 m 一 pcmget , m _ pcmlen , m . pcmon , n^pcmrec 
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M PGMF LT 


MUSIC3 


害•式 m 猶 pgmflt ( [ c ] [. md ]) 


引 数 


char 


戻り使 int 


機 能 I MML データの音色の切り替えコマンドを、指定チャンネルの 

演奏時に出力するかどうかを選択します。 

c . ネャンネル番号 （1 〜25> 

md . 0=鼬を出力すろ。 

l =@ n を出力しない。 

c が 省略され た場合は、全てのチャンネルに md を設定します。 

rad が 省略され た場合は、現在の設定値を返します c 

戻り値として、正常なときは0、エラーのときは-丨を返します。 



m _ panf 1 1 , m . voIf 11 


M PLAY 


MUSIC 


了 

式 


引 

数 


戻 

り僅 


1 « 

能 


m.play ( ( cl ] [, c 2 ] し c 3] し c 4〕 [, c 5) し c 6〕 し c 7〕 [, cS ]) 


char 


int 

cl 〜 c 8 で指定されたチャンネルに割り当てられたトラックの楽譜デー 
夕を演奏します。 

cl 〜 c 8 ••••チヤ ンネル番号< 1〜 25) 
cl 〜 c 8 をすベて省略すると、全チャンネルを演奏します。 

戻り値として、正常なときは0、エラーのときは -1 を返します。 
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PNMGET 


MUSIC3 



ra . pnmget ( nt ) 


char 



り值 



一卜番号 nt に登録されている PCM の音色名を取得します。 
nt . ノー ト番号 (0 〜127〉 


m pnmset 


PNMSET 


MUSIC 3 



id. pnmset ( nt ， pn ) 


char ( nt ), str ( Pn > 


int 



ノー ト番号 nt に PCM の音色名を登録します。（半角10文字以内) 

nt . ノー ト番号 (0 〜127〉 

pn . P CM の音色名 

戻り値として、正常なときは0、エラーのときは-1を返します。 


ra.pnmget 
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M PROG 


MUSIC 3 


害 

式 


引 

数; 


戻》 

) 値 


機 

能 


m _ prog ( [ c ] し p ] > 


char 


int 

指定のチャンネル c に音色番号 p で示される音色を設定します。 

c . チャンネル番号（丨〜25> 

P . 音色番号 ( FM 音源は1〜200、 MIDI は1〜128) 

C が省略された場合は、全てのチャンネルに VO を設定します。 
P が省略された場合は、現在の設定値を返します。 

戻り値として、正常なときは0、エラーのときは-1を返します。 


M SND SET 


HUSIC 3 



式 


引 

数 


戻 

り値 

機 

W ] 


m _ sndset ^ ca ) 


char 型一次元配列 ( ca > 


SOUND PR 0-68 K の S N D ファイル形式のデータを F M 音源用のデータ 
として登録にします。同時に音色名も登録します。 

ca . S N D ファイル形式のデータ 

1音色8 0バイトで最大2 0 0音色 （=16000 バイト） 
まで指定できます。 

戻り値として、正常のときは0、エラーのときは-1を返します。 
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M SOLO 


MUSIC 3 


書 

式 


引 

数 


戻 

り值 


機 

能 


m _ solo ( [ c ] > 


char 


int 

指定されたチャンネル c 以外の全ての音をミュートします。 

c . チャンネル番号 （1 〜25> 

c を省略するか0を指定すると解除されます。 

戻り値として、正常のときは0、エラーのときは -1 を返します。 



m_mu t e 


M START 


MUSIC 3 


與 式 



m . start ( ra ) 
int 

int 

演奏を開始する小節を設定します。 

m . 演奏を開始する小節番号 

m-play 関数を実行することにより、小節番号 m の小節より演奏を開始しま 
す。全てのチャンネルの M ML データ“ 1:”，“ D . S . ”， 

“ D . C . ”，“ などの数や位餺が同じでないと正常な演奏ができませ 

ん。（一度設定された小節番号は演奏が終わるとクリアされます。） 

戻り値として、正常のときは0、エラーのときは-1を返します。 



m . end , m . meas,m play 
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M STAT 


MUSIC 


書 

式 


引 

数 


戻卜 

) 值 


機 

能 


m _ stat ( ( c ]) 
char 


int 

指定のチャンネルが演奏中なら 1 を、停止中なら0を返します。 
c . チャンネル番号（丨〜 25) 

c が省略された場合は、全てのチャンネルの状態を bi tO 〜24に返します。 
bi tO 〜24がチャンネル1〜25に対応しています。それぞれの bit が0ならば 
停止中、1ならば演奏中です。 


M STOP 


MUSIC 


I M 式 m _ stop ( [ cl 〕 し c 2〕 し c 3〕 し c 4〕 し c 5〕 (, c 6) [， c 7〕 し c 8〕> 

「引 数 ] char 
| 戻り 值 1 int 


I « 能」 c 丨〜 c 8 で指定されたチャンネルの演奏を一時停止します。 

cl 〜 c 8 ••••チャンネル番号 （1 〜 25) 

チャンネルをすべて省略すると、全チャンネルの演奏を一時停止します。 
戻り値として、正常のときは0、エラーのときは-1を返します。 



m_cont 
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M SYNC 


MUSIC3 


1 書 

式 


引 

数 


戻 

り値 


機 

能 


m _ sync ( (c ]) 
char 


int 

同期モードを設定します。 


同期モード 

c . 0内部の M I D I クロックに合わせて演奏 

1外部の M I D I クロックに合わせて演奏 
2外部の FSK クロックに合わせて演奏 
外部同期にする場合は、 m . sync ( l ) 実行後 n ^ play 関数で待機状態になり 
MIDI のスタートコマンド UF / U を待ちます。 
c を省略すると、現在の状態を返します。 

戻り値として、正常のときは〇、エラーのときは -1 を返します。 




M SYSCH 


MUSIC 3 


書 

式 


引 

数 


戻 

り值 


[機 

能 


m . sysch ( (cm ]) 
str 


int 


各音源に対するチャンネル番号の割り当てを変更します。 

( ドライバ組み込み時のオブシヨンスイッチと同じ） 

cm . 各音源のチャンネルの割り当てを示す文字列 


，，〇 PM” … 

•••0PM=chl 〜8 

PCM=ch9 

MIDI=chl0 〜 25 

，，〇 MP，， … 

••.0PM=chl 〜8 

MlDl=ch9 〜24 

PCM=ch25 

” M0P” ••• 

•••MlDI=chl 〜16 

0PM=chl7 〜 24 

PCM=ch 25 

” MP0，，••• 

•••MIDI=chl 〜16 

PCM=chl7 

0PM=chl8 〜 25 

” P0M，，". 

•••PCM=chl 

0PM=ch2 〜 9 

MIDI=chl0 〜 25 

” PM0，， … 

•••PCM=chl 

MIDI=ch2 〜 17 

0PM=chl8 〜 25 


cm を省略した場合は、現在のモードを数値で返します。 

( 0=，，0 PM ”，1=”0 MP ”，2=” M 0 P ”，3=” MP 0”，4=，， P 0 M ，，，5=” PM 0” > 

戻り値として、正常のときは0、エラーのときは-丨を返します。 


M TEMPO 


MUSIC 



m tempo ( [te ]) 


引 数 int 


厂戻り値 1 int 


機 能」 テンポ te を1分間に4分音符を何回打つかで指定します。 

テンポは、20〜300の範囲です。（デフォルト値は120) 
te が省略された場合は、現在のテンポを返します。 

戻り値として、正常なときは0、エラーのときは -1 を返します。 
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M TNMGET 


MUSIC 3 


書 

式 


引 

数 


戻 

り值 


機 

能 



char 


str 


音色番号 VO で示される音色データに登録されている音色名を取得しま 
す。 

vo . 音色番号（丨〜 200) 

戻り値として音色名を示す文字列を返します。（半角で10文字以内） 



ra.tnnset 


M TNMSET 


MUSIC 3 



式 


引 

数 


戻 

り偵 

機 


能 


m ^ tnmset ( vo , tn ) 
char ( vo ), str ( tn ) 
int 


音色番号 VO で示される音色データに音色名を登録します。 

vo . 音色番号 （1 〜200) 

tn . 音色名を示す文字列（半角1〇文字以内） 

戻り値として、正常のときは0、エラーのときは-1を返します。 



m.tnmget 
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M TRK 


MUSIC 


害 

式 


引 

数 


「戻 

り值 


機 

能 


■_ trk ( t , st ) 
char ( t ), str ( st ) 


MML による楽譜データをトラック t に害き込みます。厳密にいうと 
トラック t に楽譜データを追加していきます。 
t . トラック番号 （1 〜80> 

st . MML (ミュー ジックマクロランゲージ）データ 

MML データの終端は、ヌル文字（〇)です。 

戻り値として、正常なときは〇、エラーのときは-1を返します。 


M TRN S 


NUSIC 3 


* 

式 


引 

数 


m _ trns ( [ c ] し stp ] > 
char 


戻り偵 int 


機 能 指定のチャンネル c の音程をシフトします。（半音ごとに土 2オクターブ 

の範囲） 

c が省略された場合は、全てのチャンネルに stp を設定します。 
stp が省略された場合は、現在の設定値を返します。 

C . チャンネル番号 

Stp . 音程を移調するデータ （0 〜48> 

デフォルト値は24 

戻り値として、正常のときは0、エラーのときは-1を返します。 
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M USE 


MUSIC 3 


害 式 


引 数」 

値」 

機能 


M VE 


3 L 数： 

I り—値 

» 能 


m _ use ( [ t )) 


char 


int 

指定のトラックバッファ t の使用容量を返します。 
t . トラック番号 （1 〜80> 

t を省略した場合は、全てのトラックバッファの合計使用容量を返します。 
戻り値として、正常のときは0、エラーのときは-1を返します。 


L 


MUSIC 3 


m.vel ( (c ) [, vel )) 


char 


int 


指定のチャンネル c のべロシティを設定します。 

c . チャンネル番号（丨〜25> 

vel . ベロシティデータ （0 〜127〉 

c が省略された場合は、全てのチャンネルに vel を設定します。 
vel が省略された場合は、現在の設定値を返します。 

戻り値として、正常のときは0、エラーのときは-1を返します。 
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M VGET 


MUSIC 


書 

式 


引 

数 


戻卜 

) 値 


機 

能 


m vget ( vo , ca ) 


char (vo >, char 型二次元 (4,10> 配列 名 ( ca > 


int 

音色データを配列 ca に読み込みます。 
vo . 音色番号 （1 〜200) 

ca . 音色データを格納するための char 型二次元配列名。 

配列の次元は、(4,10)〇 

戻り値として、正常なときは〇、エラーのときは -1 を返します。 



ni-vset 


M VOL 


MUS 1 C 3 



式 


引 

数 


戻 

り值 


機 

能 


m . vol ( [ c 〕し vol 〕 > 
char 


int 

指定のチャンネル c にボリユーム vol を設定します。 

c . チャンネル番号 （1 〜 25) 

vol . ボリ ユームデータ （0 〜127〉 

c が省略された場合は、全てのチャンネルに vol を設定します。 
vol が省略された場合は、現在の設定値を返します。 

戻り値として、正常のときは0、エラーのときは-1を返します。 



m.mstvol 
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M VOLF LT 


MUSIC 3 


L 書 

式 


引 

数 


戻 ^ 



機 

能 


m _ volflt ( ( c ) [, md ]) 

char 


int 

MM L データのボリューム設定コマンド Vn , eVn を、指定チャンネルの 
演奏時に出力するかどうかを選択します。 


c . チャンネル番号 （1 〜 25) 

wd . O = V n ,0 Vn を出力する 

い Vn , gVn を出力しない 


c が省略された場合は、全てのチャンネルに ra j を設定します。 
md が省略された場合は、現在の設定値を返します。 

戻り値として、正常のときは0、エラーのときは -1 を®します。 



m.panf It , m_pgnf 11 
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M VSET 


MUSIC 



m . vset ( vo , ca ) 

char ( vo ), char 型二次元 (4,10) 配列名 ( ca ) 
int 

配列 ca に格納されている音色データを指定された音色番号 vo のメモリ 
バッファに登録します。 

vo . 音色番号 <1〜20(0。1〜68は登録済 0 

ca . 音色データが格納されている char 型二次元配列名。 

配列の次元は(4，10)。 


音色データの配列形式 



0 

1〜4( 

才へ•レ-夕〉 

0 

フィードバック/アルゴリズム （0 〜63> 

A R 

(0 〜31> 

1 

スロットマスク 

(0 〜 15> 

D 1 R 

(0 〜31> 

2 

ウェーブフォーム 

(0 〜 3> 

D 2 R 

(0 〜 31) 

3 

シンクロ 

<0,1) 

R R 

<0〜 15) 

4 

スピード 

(0 〜255) 

D 1 L 

(0 〜 15) 

5: 

PM D 

(0 〜127) 

T L 

<0〜 127) 

6 

AMD 

(0 〜 7> 

K S 

(0 〜 3) 

7 

PMS 

(0 〜 3> 

MU L 

(0 〜15〉 

8 

AMS 

(0 〜 3) 

DTI 

(0 〜 7) 

9 

L , R P AN 

(0 〜 3> 

DT 2 

(0 〜 3) 

10 



AMS イネーブル （0,1) 


なお、オペレータ1は Ml (モジュレータ 1) 、オペレータ2は C 1 (キャリ 
ア 1) 、オペレータ3は M 2 (モジュレータ 2) 、およびオペレータ4は C 2 
(キヤリア 2) に対応しています。 


戻り値として、正常のときは0、エラーのときは-1を返します。 



m vget 
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M YCOM 


MUSIC 3 


1書 

式 


引 

数 


戻 

り值 


機 

能 


m . ycom ( [md ]) 
char 


int 

md =0 で Y コマンドを M I D I のコントロールデータと解釈します。 
md = l で Y コマンドを0 PM レジスタの害き換えと解釈します。 
md を省略した場合は現在のモードを返します。（デフォルト=1> 
戻り値として、正常のときは0、エラーのときは-丨を返します。 


44 






ee 

ay 

at 

op 




.sync 
■meter 
■sndset 
•pcmset 
■sysch 
.ifchk 
f reea 
out 
meas 
ycon 
start 
end 

modsns 

pcmrec 

pcmget 

pcmIen 

pcmbsy 

pcmon 

ctrl res 

opmreg 

mdreg 

tnmset 

tnmget 

pnmset 



トラックバ ッフ ァの初期化 
指定トラックのトラック バッファの 確保 
指定チャンネルのトラック設定 
FM 音源の音色データ取得 
FM 音源の音色を設定 
テンポ指定 

皆定トラックに MML データをセット 
指定トラックバッファの残りバイト数を返す 
指定チャンネルの演奏開始 
指定チャンネルの演奏状態を返す 
指定チャンネルの演奏を一時停止 
指定チャンネルの演奏再開 
&定トラックバッファの先頭アドレスを返す 
指定トラックバッファの使用容*を返す 
データ出カチャンネルを一時変更 
指定チャンネルの音色番号設定 
皆定チャンネルにボリユーム設定 
指定チャンネルのパンボット指定 
指定チャンネルのベロシティ設定 
指定チャンネルの音程シフト 
指定チャンネルへのオールノー トオフ出力 
M I D I 出力 

指定チャンネルの発音許可 
指定チャンネルへノートオン出力 
指定チャンネルへノー トオフ出力 
MIDI の同期モードを設定 
曲の拍子設定 

SND フ 7 U のデータを F M 音源用に登録 
指定の音程に PCM 音を登録 
チャンネル番号の割り当て変更 
M I D I インターフェイスの有無チェック 
卜”ラィ，起動時のトラ”/ r ，ハの全/いィト数を返す 
1バイトデータを MI D I へ出力 
演奏中の小節番号を返す 
Y コマンドの解釈 
演奏開始小節の設定 
演奏停止小節の設定 
FM 音源のモジユレーシヨンの深さ設定 
外部入力音の PCM 録音 
登録されている PCM データの取得 
指定された P CM データのサイズを返す 
PCM の実行状態を返す 
旨定された P CM データの再生 
旨定チャンネルへの各種のオフ出力 
指定の 0 PM レジスタにデータをセット 
MIDI 制御 I C のレジスタにデータをセット 
FM 音源の音色名の登録 
FM 音源の音色名の取得 
PCM 音色名の登録 


55 

48 

49 
86 
88 
82 

83 

54 

75 

78 

79 

51 

49 

84 

50 

76 
86 
67 

85 

84 

48 

52 

52 
64 
63 

80 
57 

77 
73 
81 

55 
54 
67 

57 
89 

78 

53 

58 
72 
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$00 

$01 
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$03 
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番号 


ー ル番号顧） 


リ （OP 


8ライブラリ- 


8 9 A 

11 11 n 


n g 

eao 丨 n I 


019ABCF0 2345689 ABCDEF012 
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番号 


機 


&号 

名 前 

機能 頁 

$43 

m.pnmget 

PCM 音色名の取得 

75 

$44 

m_mstvol 

マスターボリュームの設定 

61 

$45 

m.bend 

指定チャンネルのピッチベンド設定 

50 

$46 

m.fflod 

指定チャンネルのモジュレーシヨン設定 

58 

$47 

Di.opnexc 

FM 音源のパラメータ セッ トの選択 

65 

$48 

m.opm1iq 

FM 音源の L F 0 の発振周波数の設定 

65 

$49 

m.pgmf 11 

MML 音色切り替えコマンドの出力選択 

74 

S4A 

m.volf!t 
m.panf 11 

MML ボリューム設定コマンドの出力選択 

87 

$4B 

MML パンボット設定コマンドの出力選択 

68 

$5E 

m.version 

0PMDRV3.X のバージヨンと作成日付を返す 

85 


ra.errget 

直前の MUSIC 関数のエラーコードを返す 

53 


m.mcont 

ビツトパターン指定チャンネルの演奏再開 

56 


m_mplay 

ビットパターン指定チャンネルの演奏開始 

59 


m.nstop 

ビットパターン指定チャンネルの演奏一時停止 

60 


m_mute 

指定チャンネルの音を消音 

62 


m.pcnc1r 

P CM バツ ファのクリア 

69 


DJ-SOlo 

指定チャンネル以外の音を消音 

77 








1.9 ライブラリリファレンス 


「C compiler PR 0-68 K v e r 2 .1 J では、 （FM 音源/ MIDI 
/ADPCM を制御できる） OPMDRV 3. X 用のライブラリがサボートされてい 
ます。 


これにより、新しく次のファイルが v e r 2. 1より追加/変更されています。 


ファイル名 

[ --- ■■ 一— ■ 、 

内 容 

MUSIC.H 

MUS1C3.H 

BASLIB.L 

L —■ - 1 

■ ■ ■ ■ ■_■■■■■■■ ■ ■ , ■ ■ ■ 1 

FMg 源 （ MIDI/ADPCM 対応）用関数の定義 

FM 音源 / MID1/ADPCM 用拡張関数の定義 

BASTOC ライブラリ 


なお 、 「C compiler PRO — 68 K v e r 2 . Oj でサボートされていた 
OPMDRV 2. X 用のライブラリ （「 C コンパイラライブラリーマニュアル1」を 
参照）は新しい 0 PMDRV 3. X 用のライブラリではサボートしていませんのでご 
注意ください。 


従来の 0 PMDRV 2. X 用のライブラリをご使用になりたい場合は、システムディ 
スク2の MUSIC ディレクトリに入っているファイルをご使用ください。 
(0 PMDRV 3. X 用のライブラリと同時に利用することはできません） 
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書 式 # include く music . h 〉 


int o . alloc ( t ， s >; 

char t ; /* トラック番号 （1 〜 80) */ 

int s ； /* バッファサイズ （1 〜 65535) */ 

機 能 j 指定トラックのトラックバッファを確保します。 

全トラックバッファ内のデータはクリアされます。 

また、バッファサイズに1〜3を指定しても、 4 バイト確保します。 
t をに-1または’ NASI ’ を指定した場合、全てのトラックをバッファサイズ 
s で確保します。 

なお、総トラックのバッファサイズ（それぞれのトラックに割り当てら 
れているトラックバッファの総合計）は、 CONFIG . SYS ファイ 
ル内の OPMDRV 3. X のあとに指定して、再度システム起動するこ 

とにより変更できます。 

DEVICE = ¥ SYS ¥0 PHDRV 3 .X #nnn 
(nnn :総トラックバッファサイズ[単位 ： K B ]) 


戻り使 正常終了の場合は0を返します。 

エラーの場合は-1を返し、そのエラーコードは n ^ errget 関数で調べるこ 
とができます。 


m ant of f 


レベル 3 


萬 式 


# include < music 3. h > 


int m _ antoff < c ); 

int c ; /* チャンネル番号 （1 〜 25> */ 


» 能」 指定のチャンネルへオールノー トオフを出力します。 

c に-1または’ NASI ’ を指定した場合、全てのチャンネルへオールノー ト 
オフを出力します。 


D 戻り値」 正常終了の場合は〇を返します。 

エラーの 場合は-1を返し、その エラーコー ドは！^ errget 関数で調べる 
とができます。 
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m_assign - 

レベル 3 


書式 # include < music . h > 


int m _ assign ( c , t )； 

char c ； /* チャンネル番号（丨〜 25> 本/ 

char t ; /* トラック番号 （1 〜 80> */ 


機 能 指定のチャンネル c で使用するトラック t を設定します。 

t に-1または’ NAS ドを指定した場合、チャンネル c に設定されているトラ 
ック番号を返します。 

複数のチャンネルに同一のトラックを割りあてると、それぞれ同じ楽譜 
データを演奏します。 

また、複数のトラックを1つのチャンネルに割りあてると、最も新しく 
割りふられたトラックの楽譜データを演奏します。 

デフオルト値は、チャンネル1〜2 5が、それぞれトラック1〜2 5に 
対応します。 


戻り 儀1 正常終了の場合は〇を返します。 

エラーの場合は -1 を返し、そのエラーコードは m - errget 関数で調べるこ 
とができます。 

t に-1または’ NAS 1’ を指定した場合、チャンネル c に設定されているトラ 
ック番号を返します。 


m at 〇 i - 

レベル3 



#include く music . h > 
int m_atoi ⑴； 

char t ; /* トラック番号 （1 〜 80) */ 


機 能 



トラック t のトラックバッファ先頭アドレスを返します。 

トラックバッファは、 OPMDRV 3. X の内部バッファのため、スー 
バーバイザ領域です。 

データのアクセスには、注意してください。 

トラックバッファの先頭アドレスを返します。 
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m bend 


レベル 3 


書式 #include < music 3. h > 


int m . bend ( c , b )； 

int c ； /* チャンネル番号 （1 〜 25> ♦/ 

char b ； /* ビッチベンドデータ （0 〜127〉 */ 


機能 指定のチャンネルのビッチベンドを設定します。 

c に-1または’ NAS ドを指定した場合、全てのチャンネルに b を設定しま 
す 0 


L 戻僅」 正常終了の場合は〇を返します。 

エラーの場合は-1を返し、そのエラーコードは mjrrget 関数で調べるこ 
とができます。 


111 - chan - ^ 



#include < music 3. h > 
int m _ chan ( c 1, c 2 )• 

char cl ; /* チャンネル番号 < 1 〜 25) */ 

int c 2; /♦ 出カチャンネル番号 （1 〜 25> */ 


指定のチャンネルのデータ出カチャンネルを一時的に変更します。 
c 2 に-1または 1 ASI ’ を指定した場合、現在の設定値を返します。 
reassign 関数や MML データ 0 N とは異なり、チャンネル変更前のパラ 
メータ《トラック番号、音色番号、ボリュームなど）を引き継ぎます。 
nijnit 関数実行まで有効です。 

正常終了の場合は0を返します。 

エラーの場合は-1を返し、そのエラーコードは！ D _ errget 関数で調べるこ 
とができます。 




参照関数 m.ini t 


50 




int m . cont ( cl , c 2, c 3, c 4, c 5, c 6, c 7, c 8); 

int cl ， c 2， c 3， c 4， c 5， c 6， c 7， c 8; /♦ チャンネル番号 （1 〜 25) 本/ 


機 j 」 cl から c 8 で指定されたチャンネルにおいて、一時停止した演奏を再開し 

ます。 

指定するチャンネルの個数が7個以下の場合は余りの引数に’ NASI ’ を指 
定しなければなりません。 

cl 〜 c 8 が全て’ NAS ドならば、1〜25チャンネル中、現在一時停止していた 
チャンネルを全て演奏再開します。 

戻り值1 正常終了の場合は0を返します。 

エラーの場合は-1を返し、そのエラーコードは lerrget 関数で調べるこ 
とができます。 

[ 参照関数 j m.stop 


m_ctrI res _ 

レベル 3 


冉 式 #include < music 3. h > 


int H . ctrIres ( c )； 

int c ; /* チャンネル番号 （1 〜 25) */ 


能 指定のチヤンネルへビッチベンドオフ/モジュレーションオフ/ダン 
バーオフ/オールノー トオフを出力します。 

c に -1 または’ NASI ’ を指定した場合、全てのチャンネルへビッチベンドオ 
フ/モジユレーシヨンオフ/ダンパーオフ/オールノー トオフを出力し 
ます。 


戻り值| 正常終了の場合は0を返します。 

エラーの場合は-1を返し、そのエラーコードは iD-errget 関数で調べるこ 
とができます。 
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m dirout 


レベル 3 


書式 # include < music 3. h > 


int m _ dirout ( lng , ca )； 

int Ing ； /* データサイズ*/ 

char * ca ; /* MIDI データの先頭アドレス ♦/ 


依 能 Ing バイトの M I D I データを M I D I へ出力します。 


戻り值1 正常終了の場合は〇を返します。エラーの場合は-1を返し、そのエラー 

コードは!^ errget 関数で調べることができます 0 


参照閲数 m.out 


m enable - 

— レベル3 


書式 #include < nusic 3. h > 


int m _ enable ( cp )； 

int cp ； /* チヤンネルのビットパターン*/ 


« 能」 ビットパターンで指定されたチャンネルの発音を許可します。 

ビット〇〜24がチャンネル1〜25に対応しており、発音を許可したいチャ 
ンネルに対応したビットに1を指定します（他のビットは常に0です）。 
cp に0を指定した場合、全てのチャンネルの発音を許可します。 
cp に-1または ‘NAS ドを指定した場合、全てのチャンネルの状態を bitO 〜 

24に返します。 

ra - nmte 関数と ra _ S 0 | 0 関数のミュート設定は解除されます。 nonstop 関数と 
は異なり、ノー ト以外のデータは常に出力されています（ミュート状態）。 


正常終了の場合は0を返します。エラーの場合は-1を返し、そのエラー 
コードは ！^ errget 関数で調べることができます 0 


考照 I 対数 m _ mcont , m . mplay , m _ mstop , m . mute , m.solo 
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m end - 

— レベル 3 



# include < music 3. h > 


int m . end ( m )； 

int m ； /♦ 小節番号*/ 


機能 演奏を停止する小節を設定します。 

全てのチャンネルの I : D.S D.C :丨などの位置が同じでないと正常な 
演奏ができません。 


正常終了の場合は〇を返します。 

エラーの場合は-1を返し、そのエラーコードは mjrrget 関数で調べる 
とができます。 

参照関数 upstart 



m errget 


レベル3 


其 式 # include < music 3. h > 


int m . errget ()； 


直前の MU S I C 各関数で始まる関数）のエラーコードを返します。 
エラーコードについては、「1.13エラーコード ー覧 J を参照してく 
ださい。 


正常終了している場合は〇を返し、エラーの場合は1〜65のエラーコード 
を返します。 
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I 書 式 


lude く music.h> 


int m - free ⑴； 

char t ； /* トラック番号 （1 〜 80> */ 



指定のトラック t のトラックバッファの残りバイト数を返します 


[戾り值]トラックバッファの残りバイト数を返します 


参照関数 


f reea 


m freea 


レベル 3 


書 式 


林 include < music 3. h > 


int ■• freea (>; 


ドライバ起動時に確保したトラックバッファの全バイト数を返します。 


[戾り值 j トラックバッファの全バイト数を返します 


f 参照関数一; 


し free,m use 
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m - ifchk - ^ 


書 式 


拌 include < music 3. h > 


int mifchk ()； 


M I D I インターフェイスの有無をチェックします。 

インターフェイスがつながっている場合は0、つながっていない場合は 
-1 を返します。 




m i n i t 


レベル 3 


與 式 ttinclude < music . h > 


int m ^ init ( md )； 

int md ; /* 初期化モード */ 

m トラックバッファを初期化します。 

各トラックバッファは4バイトに設定されます。 

また、各チャンネルのパラメータ（トラック番号、音色番号、ボリュー 
ムなど）も初期化されます。 

rad に1を指定した場合、 FM 音源の音色データも初期化します。 
md に0または’ NASI ’ を指定した場合は音色データは初期化しません。 

m ] 正常終了の場合は〇を返します。 

エラーの場合は-1を返し、そのエラーコードは n^errget 関数で調べるこ 
とができます。 
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m mcont 



轉 include < music 3. h > 


int m . mcont ( cp )； 

int cp ； /* チヤンネルのビットパターン*/ 


機 能」 ビットパターンで指定されたチャンネルの演奏を再開します。 

ビット〇〜2 4 がチャンネル1〜25に対応しており、演奏を再開したいチャ 
ンネルに対応したビットに1を指定します（他のビットは常に0です）。 
cp に0または-1、 ’ NASI ’ を指定した場合、全てのチャンネルの演奏を再 
開します。 


正常終了の場合は0を返します。 

エラーの 場合は-1を 返し、そのエラーコー ドは ra _ errget 関数で调 ベるこ 
とができます。 



参照関数 


m . enable , m . mplay , m.mstop 


m - mdreg - ^ 


書 式 #include < music 3. h > 


int m _ mdreg ( gr , adr , dt )； 
char gr ; /* グルーブ番号*/ 

char adr ； /* アドレス番号*/ 

char dt ； /* 書き込むデータ */ 


機 能 MIDI 制御 IC ( YM 3802) のレジスタに値を書き込みます。 

gr にはグルーブ番号、 adr にはアドレス番号、 dt にはレジスタに書き込む 
値を〇〜255の範囲で指定します。 


正常終了の場合は0を返します。 

エラーの場合は-1を返し、そのエラーコードは m _ err get 関数で調べる こ 
とができます。 
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害 式 


#include < music 3. h > 


int m.measO ； 


m jg 現在演奏中の小節番号を返します。 

丨： D . S . などのくり返し記号の場合はくり返し回数がそのまま加算され 
ますので、実際の小節番号とは異なる場合があります。 



現在演奏中の小節番号 


[ 参照関数」 m _ end , m.start 



meter 


レペル3 



int m _ meter ( n , d )； 

char n ; /* 分子 <2 〜 16> ♦/ 

chard ; /* 分母 (2, 4,8,16〉 */ 


| AS 能 | 曲の拍子を設定します。 

デフォルト値は4/4拍子に設定されています。 



正常終了の場合は0を返します。 

エラーの場合は-丨を返し、そのエラーコードは m - errget 関数で調べるこ 
とができます。 




書 式 # include < music 3. h > 


nt m _ mod ( c , m )； 

nt c ； /* チャンネル番号 （1 〜 25) */ 

nt in ； /* モジュレーションデータ <0 〜127〉 */ 


能」 指定のチヤンネルのモジユレーシヨンを設定します。 

c に-1または ‘ NASI ’ を指定した場合は、全てのチャンネルに m を設定 
します。 


戻り值 


正常終了の場合は0を返します。 

エラーの 場合は-1を返し、 そのエラーコー ドは m - errget 関数で调 ベるこ 
とができます。 


| #照阒数 


m.raodsns 



int m . modsnstni ) ； 

int m ; /* モジュレーションの深さ （0 〜127〉 */ 


ffi 能」 FM 音源全体のモジユレー シヨ ンの深さを設定します。 

m にべまたは ‘ NASI ’ を指定した場合は、現在の設定値を返します。 


I 戻り 值 I 正常終了の場合は0を返します。 

エラーの 場合は-1を返し、 そのエラーコー ドは m - errget 関数で調べる こ 
とができます。 

m に-1または ‘ NASI ’ を指定した場合は、現在の設定値を返します。 


冬照 I 勿数 m_mod 
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「書 式 


#include < music 3. h > 


int m . mplay ( cp )； 

int cp ； /* チャンネルのビツトパターン*/ 

ビットパターンで指定されたチャンネルの演奏を開始します。 

ビット〇〜24がチャンネル1〜25に対応しており、演奏を開始したいチャ 
ンネルに対応したビットに1を指定します（他のビットは常に0です）。 
cp に0または-1、 ‘ NASI ’ を指定した場合、全てのチャンネルの演奏を開 
始します。 

例）チャンネル1〜13とチャンネル22〜25の演奏を開始します。 
m _ mplay (& blll 10000000011111111111 11) 

戻り一值]正常終了の場合は〇を返します。 

エラーの場合は -1 を返し、そのエラーコードは！^ errget 関数で調べるこ 
とができます。 




m enable , m _ mconi , m.msiop 
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int m^mstop(cp )； 

int cp ； /* チヤンネルのビットパターン */ 


機 m ビットパターンで指定されたチャンネルの演奏を一時停止します。 

ビット〇〜24がチヤンネル1〜25に対応しており、演奏を一時停止したい 
チヤンネルに対応したビットに1を指定します（他のビットは常に〇で 
す ） 。 

cp に 0 または- 1 、 ， NASI’ を指定した場合、全てのチャンネルの演奏を 一 
時停止します。 


I 戻 り偵 j 正常終了の場合は0を返します。 

エラーの 場合は- 1 を 返し、そのエラーコー ドは m-errget 関数で調べる こ 
とができます。 


[ 参照関数 


m.enable,m.mcont , m.mplay 



^include <music3.h> 


int m . mstvol ( v )； 

int v ; /* ボリュームデータ （0 〜127) */ 

マスターボリュームを設定します。 

デフォルト値は127に設定されています。 

v に-1または ‘ NAS 1’ を指定した場合、現在の設定値を返します。 
nUnit 関数を実行するまで有効です0 
P CM のチャンネルに対しては無効です。 

正常終了の場合は〇を返します。 

エラーの場合は-1を返し、そのエラーコードは m—errget 関数で調べるこ 
とができます。 

v に -1 または ‘ NAS ドを指定した場合、現在の設定値を返します。 







書 式 


# include < music 3. h > 


int m _ mute ( cl ， c 2, c 3, c 4, c 5, c 6, c 7, c 8>; 

int c 1 ， c 2, c 3, c 4, c 5, c 6, c 7, c 8; /* チャンネル番号 （1 〜 125 ) */ 

機 能] cl から c 8 で指定したチャンネルの音をミュート（消音〉します。 

ノー ト以外のデータは常に出力されます。 

cl から c 8 が全て ’ NASI ’ ならば全てのチャンネルのミュートが解除され 
ます。 

8個以上のチャンネルを同時にミュートする場合は、 m _ enable 関数を使用 
してください。 

戻り 值]正常終了の場合は〇を返します。 

エラーの場合は-1を返し、そのエラーコードは lerrget 関数で調べるこ 
とができます。 


参照関数 


m _ enable ， m.solo 


62 



m ntoff 


杯 inc lude <music3.h> 

int m.ntoff(c,nt,vel )； 
char c ； /♦ チャンネル番号 （1 〜 25) */ 

char nt ； /* ノー ト 番号 (0 〜 127) ♦/ 

int vel ； /* ベロシティ （0 〜 127) ♦/ 

機能」 指定のチャンネルへノー トオフを出力します。 

vel に- 1 または 'NASI* を指定した場合、ベロシティ値を 6 4 で出力しま 
す0 


戻り鎖| 正常終了の場合は D を返します。 

エラーの場合は-1を返し、そのエラーコードは Lerrget 関数で調べるこ 
とができます。 

#照閲数 m.nton 




m nton 


レペル 3 


書式 


機 能 


戻り值 


L 参照阒数 


# include < music 3. h > 

int m _ nton ( c , nt , vel )； 
char c ; /* チャンネル番号 （1 〜 25 ) ♦/ 

char nt ; /* ノー ト 番号 (0 〜 127 ) */ 

int vel ； /* ベロシティ （0 〜 127 ) */ 


指定のチャンネルへノー トオンを出力します。 

vel に-1または ‘ NASI ’ を指定した場合、ベロシティ値を64で出力しま 
す0 


正常終了の場合は〇を返します。 

エラーの場合は-丨を返し、そのエラーコードは！ n _ errget 関数で調べる 
とができます。 


mntof f 



m_opmexc 


レベル 3 




林 include < music 3. h > 


int m ^ opmexc ( md )； 

int md ； /* パラメータなどの設定スイッチ*/ 


» 能 FM 音源に セツ トするパラメータの内、 LFQ / PMD / AMD など 

の全体に影 W するパラメータを音色切り替え時に セツ トするかどうかを 
選択します。 

〇を指定するとセツトしません。 

1を指定するとセツトします。デフォルト値は1です。 

md に M または ‘ NASI ’ を指定した場合、現在の状態を返します。 


正常終了の場合は0を返します。 

エラーの場合は-1を返し、そのエラーコードは m - errget 関数で綢ベるこ 
とができます。 

rad に-1または ‘ NASI ’ を指定した場合、現在の状態を返します。 



参照開数 


m.vset 


m opmI f q 



^include < music 3. h > 


int m . opmlfq ( spd )； 

int spd ； /* スピード */ 


| 機 能」 FM 音源の L F 0 の発振周波数（スピード）を設定します。 

〇〜255を指定します。デフォルト値は198です。 

spd に -1 または ‘ NAS 1’ を指定した場合、現在のデータを返します。 


戻り值 正常終了の場合は0を返します。 

エラーの 場合は-1を返し、 そのエラーコー ドは^ errget 関数で調べる こ 
とができます。 

spd に-1または - NASI * を指定した場合、現在のデータを返します。 
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m_opmreg 


レベル 3 



#include <music3.h> 
int m_opmreg(reg,data )； 

int reg ； /* 0 P M レジスタ番号 （0 〜255) */ 
int data ； /* OPM へ 書き込むデータ （0 〜 255) */ 


m 指定の 0 PM レジスタにデータをセットします。 

data に-1または’ NASI ’ を指定した場合は、現在のデータを返します。 

一度も指定の0 PM レジスタが書き換えられていない場合は、一1を返 
します。 

reg , data 両方に-1または’ NAS 1’ を指定した場合は、0 PM レジスタバッ 
ファのボインタを返します。 

0 PM レジスタバッファは、各レジスタにつき2バイトずつ計512バ 
イトあり、現在までにレジスタが害き換えられなかった場合は、そのレ 
ジスタ位置に 一 1(ワード）がセットされています。 

◦ PM レジスタバッファは、 OPMDRV 3. X の内部バッファのため、 
スーパーバイ ザ ー 領域です。 

データのアクセスには、注意してください。 


正常終了の場合は〇を返します。 

エラーの場合は-1を返し、そのエラーコードは lerrget 関数で調べるこ 
とができます。 

data に-1または’ NAST を指定した場合は、現在のデータを返します。 
reg , data 両方に-丨または ’ NASI ’を指定した場合は、0 PM レジスタバッ 
ファのボインタを返します。 




m—out - 

— レべ•ル 3 


書式 # include < nusic 3. h > 


int m . out ( data )； 

char data ； /* MIDI データ*/ 


機能 1 バイトデータを M I D I へ出力します。 


戻り值 正常終了の場合は0を返します。エラーの場合は-1を返し、そのエラー 

コードは n _ er rget 関数で調べることができます。 


参照鬨数 m_dirout 


m pan - 

レベル3 


書式 #include < music 3. h > 


int m _ pan ( c , pan ); 

int c ； /* チャンネル番号 （1 〜 25) */ 
int pan ； /♦ バンポツトデータ （0 〜127) */ 


機 能」 指定のチャンネルのパンボットを設定します。 

パンボットデータ 

〇 :ライト（右端） 

馨 

齡 

64 ••センター（中央） 

127 :レフト（左端） 

c に -1 または’ NASI ’ を指定した場合は、全てのチャンネルに pan を設 
定します。 

Pan に-1または’ NAS ドを指定した場合は、現在の設定値を返します。 


正常終了の場合は0を返します。エラーの場合は-1を返し、そのエラー 

コードは m — errget 関数で調べることができます。 

pan に-1または’ NASI ’ を指定した場合は、現在の設定値を返します《 
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m_panf1t 


レペル 


書 式 


lude < music 3. h > 


int m _ panf 1 t ( c , md >; 

int c ; /* チャンネル番号 （1 〜 25) */ 

int md ； /* フィルタモード*/ 


MML データ内の PAN の切り替えコマンドを、指定チャンネルの演奏 
時に出力するかどうかを選択します。 
md に0を指定した場合、フィルタをオフします。 
md に1を指定した場合、フィルタをオンします。 

c に -1 または’ NASI ’ を指定した場合は、全てのチャンネルに md を設定し 
ます。 

md に-1または’ NASI ’ を指定した場合は、現在の設定値を返します。 


戻り正常終了の場合は〇を返します。 

エラーの場合は-1を返し、そのエラーコードは lerrget 関数で調べる 
とができます。 

md に-1または’ NASI ’ を指定した場合は、現在の設定値を返します。 


m . pgmfIt , ra.volfIt 


m_pcmbsy 


レベル 3 


ftinclude <music3.h> 
int m^pcmbsy ()； 

I « 能」 PCM の実行状態を調べます。 

戻り值 | PC M の実行状態を以下に示す値で返します。 

0 x 00 :何も実行していない 

0 x 02 :出力中 ( ADPCMOUT ,__ pc _ on , a _ play を実行中) 
0 x 04 :入力中 ( ADPCMINP ,»_ pirec , a _ rec を実行中) 
0 x 12 :出力中 （ ADPCMA 0 T を実行中） 

0 x 14 :入力中 （ ADPCMAIN を実行中） 

0 x 22 :出力中 （ ADPCMLOT を実行中） 

0 x 24 :入力中 （ ADPCMLIN を実行中） 




int m.pcmcIrO ； 



PCM バッファをクリアします。 



正常終了の場合は0を返します。 

エラーの場合は-1を返し、そのエラーコードは n^errget 関数で調べるこ 
とができます。 



m 」 cm g et - ^ 


害 式 # incIude <music3.h> 


int m.pcmget(nt,ca, s)I 

char nt； /* ノー ト番号 （0 〜 127) */ 

char *ca； /* P C M データバッファの先頭アドレス*/ 

int s； /♦ バッフアサイズ*/ 


機能」 登録されている PCM データを ca に バッファ サイズ分読み込みます。 



正常終了の場合は0を返します。 

エラーの場合は-1を返し、そのエラーコードは mjrrget 関数で調べる 
ことができます。 


I参照関数 


m.pcmlen,m^pcmset 


m pcmlen - 

レベル 3 


番 式 #include <music3.h> 


int m_pcmlen(nt >; 

int nt； /* ノー ト番号 （0 〜 127) */ 


m 劈」 指定された P C M データのサイズを返します。 

nt に-1または ’NASI’ を指定した場合は、 P CM バッファの残り容量を 
返します。 

["戻り 值] 正常終了の場合は0を返します。 

エラーの場合は-1を返し、そのエラーコードは n^errget 関数で調べる 
ことができます。 

nt に-1または’ NAS1’ を指定した場合は、 P CM バッファの残り容量を 
返します。 


参照関数 


m^pcmset , m^pcnget 
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m_pcmon - 

— レベル 3 


書 式 


tfinclude < music 3. h > 


int ffl - pcnomnt , st , md )； 

char nt ; /* ノ ー ト番号 (0 〜 127) */ 

int sf ； /* サンプリング周波数 (0 〜 4) 本/ 

int md ： /* 音声出カモード （1 〜 3) 本/ 


機能 指定された PCM データを再生します。 

sf と md 両方に-1または’ NASI ’ を指定した場合は、サンプリング周波数:=4 
音声出カモード=3で再生します。 

サンプリング周波数 


0 . 3.9 KHz 

1 . 5.2KHZ 

2 . 7.8 KHz 

3 .10.4KHZ 

4 .15.6KHZ 

音声出カモード（オーディオ出力端子） 

1 . 左 

2 . 右 

3 . ステレオ（左右両方) 


H 值 j 正常終了の場合は0を返します。 

エラーの場合は-丨を返し、そのエラーコードは mjrrget 関数で調べるこ 
とができます。 


参照 IRJ 数 m _ pcmrec , m_pcmset 
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m_pcmrec 


レベル 3 


書 式 


« 能 


戻り値 


参照阗数 


林 include < music 3. h > 

int m . pcmrecvsf , Ing , ca )\ 

char sf ； /* サンプリング周波数 (0 〜 4> */ 

int Ing ； /* データサイズ（最大=32767) */ 

char * ca ； /♦ P C M データバッファの先頭アドレス*/ 

外部入力音（オーディオ入力端子）を PCM 録音します。 

実行直後に入力待ちになり、約4秒以内に入力がなければ実行を中止 
します。 


サンプリング周波数 


0 . 3.9KHz (一秒間に 1950 ハ••イト） 

1 . 5.2KHZ (—秒間に 2600 /TO) 

2 . 7.8KHz (一秒間に 390 On • 、イト） 

3 .10.4KHZ (一秒間に 520 〇ハ • ，イト） 

4 .15.6KHZ (一秒間に 7800 ハ"イト） 


正常終了の場合は〇を返します。 

エラーの 場合は- 1 を返し、その エラーコー ドは rojrrget 関数で調べる 
とができます。 


m.pcmon,m.pcmset 
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_pcmse t 

林 include <music3.h> 

int m_pcmset (nt, sf ,Ing, ca >; 
char nt ； /* ノー ト番号 (0 〜127) */ 
char sf ； /* サンプリング周波数 (0 〜 4> */ 
int Ing ； /* データサイズ（最大=32767〉 */ 
char * ca ; /* P C M データの先頭アドレス*/ 

指定の音程に P CM 音を登録します。 

指定できる音程は’ C -2’（0> から ’ G #8’（ 127) までです。 

サンプリング周波数 


〇 . 3.9 KHz (一秒間に 1950 A ••イト） 

1 . 5.2 KHz (一秒間に2600ハ••イト） 

2 . 7.8 KHZ (一秒間に3900 ハ • ，イト） 

3 .10.4 KHZ (一秒間に520〇ハ••イト） 

4 .15.6 KHZ (一秒間に7800 ハ、 •イト） 


戻り 値]正常終了の場合は0を返します。 

エラーの 場合は-1を返し、その エラーコー ドは ro - errget 関数で調べる こ 
とができます。 


参照閲数 m . pcmget , m _ pcmIen , m . pcmon , m.pcmrec 
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m 」 gmf 1 七 -^ 


書式 # include < music 3. h > 


int m _ pgmf 11( c ， md >; 

int c ; /* チャンネル番号 （1 〜 25) 本/ 

int md ; /* フィルタモード*/ 


m m MML データ内の音色の切り替えコマンドを、指定チャンネルの 

演奏時に出力するかどうかを選択します。 
md に0を指定した場合、フィルタをオフします。 
md に1を指定した場合、フィルタをオンします。 

c に-1または’ NAS 1’ を指定した場合は、全てのチャンネルに rod を設定 
します。 

md に-1または’ NAS 1’ を指定した場合は、現在の設定値を返します。 

—戻り供 j 正常終了の場合は〇を返します。 

エラーの場合は-1を返し、そのエラーコードは m_ err get 関数で調べる C 
とができます。 

md に-丨または’ NAST を指定した場合は、現在の設定値を返します。 


参照関数 m_panf 丨 t , m.vo If It 
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fiinclude 〈 music.h> 


int DJ - play ( cl , c 2, c 3, c 4, c 5, c 6, c 7， c 8>; 

int cl ， c 2， c 3， c 4， c 5， c 6， c 7， c 8; /* チャンネル番号 （1 〜 25) */ 

機 能」 FM 音源の指定したチャンネルに割りあてたトラックデータを演奏開始 

します。 

指定するチャンネルの個数が7個以下の場合は、余りの引数に ’ NASI ’ を 
指定しなければなりません。 

cl 〜 c 8 が全て’ NAS ドならば1〜25チャンネルを全て演奏開始します。 

「戻り值~| 正常終了の場合は〇を返します。 

エラーの場合は-1を返し、そのエラーコードは ra _ errget 関数で調べるこ 
とができます。 


m pnmget 


レベル3 


m 式 


#lnclude < music 3. h > 


char * m _ pnmget < nt >; 

char nt ; /* ノート番号 (0 〜 127> */ 


機 能 PCM のノー ト番号に登録されている音色名を取得します。 

m - pmnget 関数と m - tmnget 関数は、どちらでも続けて使用する場合、必ず 
戻り値のボインタが示す文字列をコビーしてから使用してください。 





P CM の音色名を示す文字列のボインタを返します。 


m_pnmset 


m pnmset - 

— レベル 3 


遵式 include < music 3. h > 


int m.pnmset(nt,pn)I 

char nt /* ノー ト番号 (0 〜127) */ 

char *pn /* P C M の音色名の先頭のアドレス*/ 


「機 

能 



戻 

り傾 




|参照関数丨 


P CM のノー ト番号に音色名を登録します。（半角10文字以内） 

正常終了の場合は〇を返します。 

エラーの場合は-1を返し、そのエラーコードは mjrrget 関数で調べるこ 
とができます。 

m.pnmget 


m prog 



m . prog ( c , p ) 
int m . progvc , p )； 

int c ； /* チャンネル番号 （1 〜 25> */ 

int p ； /* 音色番号 （ FM 音源：丨〜200、 M I D I :1 〜128) */ 


« 能 指定のチャンネルの音色番号を設定します。 

c に-1または’ NAS ドを指定した場合は、全てのチャンネルに p を設定 
します。 

P に -1 または’ NASI ’ を指定した場合は、現在の設定値を返します。 
データサイズは、1音色80バイトで最大200音色分 （=16000 バイト） 
まで指定できます。 


戻り值| 正常終了の場合は〇を返します。 

エラーの場合は-1を返し、そのエラーコードは m - errget 関数で調べる 
とができます。 

P に-1または’ NAS 1’ を指定した場合は、現在の設定値を返します。 
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m sndset 


レベル 3 



害 式 #include < music 3. h > 


int m . sndset ( ca , s )； 

char * ca ； /* S N D ファイル形式のデータ*/ 
int s ; /* データサイズ（最大 = 16000) */ 


機 SOUND PR 0-68 K の S N D ファイル形式のデータを F M 音源用の音色デ ー 

夕として登録します。 

同時に音色名も登録します。 

戻り 镇1 正常終了の場合は0を返します。 

エラーの 場合は-1を返し、 そのエラーコー ドは m — errget 関数で調べる こ 
とができます。 


m solo _ 

レベル3 


iif 式 # inc lude < music 3. h > 


int m _ solo ( c >; 

int c ； /* チャンネル番号 U 〜 25> */ 


機 能」 指定されたチャンネル以外の全ての音をミュート（消音）します。 

ノー ト以外のデータは、常に出力されます。 
c に0または-1、 ‘ NASI ’ を指定した場合、解除されます。 


戻り 値 正常終了の場合は0を返します。 

エラーの 場合は-1を 返し、そのエラーコー ドは m _ err g e t 関数で調べる こ 
とができます。 

c に0または-1、 ‘ NASI ， を指定した場合、解除されます。 


参照関数 m _ enable , m.mute 
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m_start - 

— レベル 3 


し書 式 # include <ausic3.h> 

int m.start(n )； 

int id ； /* 演奏を開始する小節番号 */ 


機 


1] 


演奏を開始する小節を設定します。（演奏が終わるとクリアされる） 
全てのチヤンネルの I : D . S . D . C . ：|などの数や位置が同じでないと 
正常な演奏ができません。 


戻り正常终了の塥 s は r を返します。 

エラーの場合は-丨を返し.そのエラーコードは f ^ errget 関数で調べるこ 
とができます。 


I 安頭関数 m . end , m . meas , m.play 


m stat 


レベル 3 


書式 #include < music . h > 


int m . stat ( c )； 

int c ； /♦ チャンネル番号 （1 〜 25) */ 


« 蜂」 指定のチャンネルの演奏状態を調べます。 

c に-1または’ NASP を指定した場合は、全てのチャンネルの状態を bi to 
〜24に返します。 

bitO 〜24がチャンネル1〜25に対応しています。 


戻り值 演奏中なら1を、演奏終了なら0を返します。 

• C に- 1 または’ NASI’ を指定した場合は、全てのチャンネルの状態を bi to 

〜24に返します。 
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int m_stop(cl,c2, c3, c4,c5,c6, c7, c8>; 

int cl , c 2, c 3, c4, c5, c6, c 7, c8 ； /* チャンネル 31 弓（〇 〜 2ド> */ 


L 棵 能] 指定のチャンネルの演奏を一時停止します。 

指定するチャンネルの涸数が 7 俩以下の場合は、余りの引数に NAS 1’ を 
指定しなければなりません。 

cl 〜が全て’ NAS ドならば、1〜25チャンネル中、現在演贫していたヲャ 
ンネルすべてを一時停止します 0 



正常終了の場合は〇を返します。 

エラーの 場合は -1 を返し、その エラーコー ドは n_errget 恥约 で朗 ベるこ 
とができます。 
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m_sy nc 


レベル 3 


書 式 


include < music 3. h > 


int m _ sync ( c )\ 

int c ; /* 同期モード*/ 


機 能 M I D I の同期モードを設定します。 

同期モード 


0 . 内部の M I D I クロックに合わせて演奏 

1 . 外部の M I D I クロックに合わせて演奏 

2 . 外部の F S K クロックに 合わせて演奏 


外部同期にする場合は、 m . sync ( l ) 実行後 lay 関数で待機状態になり 
MIDI の スター ト コマン ドけ FA > を待ちます。 
c に-1または’ NAS 1’ を指定した場合は、現在の状態を返します。 


戻り値 J 正常終了の場合は〇を返します。 

エラーの 場合は-1を返し、 そのエラーコー ドは rajrrget 関数で調べる 
とができます。 

c に-1または’ NAS ドを指定した場合は、現在の状態を返します。 
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int m . sysch ( cm )； 

char * cm ； /* 割り当てモードを示す文字列の先頭アドレス*/ 


機能 各音源に対するチャンネル番号の割り当てを変更します。 

( ドライバ組み込み時のオブシヨンスイッチと同じ） 

cm に-1または’ NASI ’ を指定した場合は、現在のモードを数値で返します。 


割り当てモード 


0= ，， 0PM”.OPM=chl 〜8 

1= ，， 0MP ，， .OPM=chl 〜8 

2= ，， M0P”.MlDI=chl 〜16 

3= ，， MP0”.MIDI=chl 〜 16 

4=”P0M”.PCM=chl 

5=”PM0”.PCM=chl 


PCM = ch 9 
MlDI = ch 9 〜 24 
0 PH = chl 7 〜 24 
PCM = chl 7 
0 PM = ch 2 〜 9 
MlDl = ch 2 〜 17 


MIDI = chlO 〜 25 
PCM = ch 25 
PCM = ch 25 
0 PM = chl 8 〜 25 
MlDI = chlO 〜 25 
0 PM = chl 8 〜 25 


戻り 値」 正常終了の場合は〇を返します。 

エラーの 場合は-1を返し、 そのエラーコー ドは lerrget 関数で調べるこ 
とができます。 

cm に - 1または IASI ’ を指定した場合は、現在のモードを数値で返します。 
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書式 #include < nusic . h > 


int m _ tempo ( te )； 
int te ; /* テンポ*/ 

I 機 唾 J FM 音源および MI D I の演奏時のテンポを指定します。 

テンポ te を 1 分間に 4 分音符を何回打つかで指定します。 

テンポは、 20 〜 300 の範囲です。（デフォルト値は 120) 

te に -1 または’ NASI • を指定した場合は、現在のテンポを返します。 


I 戻り 偖 I 正常終了の場合は〇を返します。 

エラーの場合は-1を返し、そのエラーコードは m—errget 関数で調べるこ 
とができます。 

te に-1または' NASI ’ を指定した埸合は、現在のテンポを返します A 


m tnmget 


咨 式 | #include < music 3 - h > 


char ♦ m^tniDget ( vo )； 

char vo ; /* 音色番号（丨〜 200) */ 


放 能」 FM 音源の音色番号で示される音色データに登録されている音色名を 

取得します。 

m - pnmget 関数と m - tnraget 関数は、どちらでも続けて使用する場合、必ず 
戻り値のボインタが示す文字列をコビーしてから使用してください。 


音色名を示す文字列のボインタを返します。 


[ 参照関数 m.tnmset 
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m tnmset_ 

レベル 3 


書式 m . tnmset ( vo , tn ) 


int m.tninset ( vo , tn )； 

char vo ； /* 音色番号 （1 〜200) */ 

char * tn ； /* 音色名を示す文字列の先頭アドレス*/ 


F M 音源の音色番号で示される音色データに音色名を登録します。 
(半角10文字以内） 


正常終了の場合は0を返します。 

エラーの場合は-1を返し、そのエラーコードは m - errget 関数で調べるこ 
とができます。 


#照関数 | m.tnmget 




m_t r k ___ 

レペル3 


遵式 #include < music . h > 


int metric ( t , st ); 

char t ; /* トラック番号 （1 〜 80> 
char * st ； /* MML データ*/ 


機 能」 MML による楽譜データをトラック t に害き込みます。 

厳密にいうとトラック t に楽譜データを追加していきます。 
MML データの終端は、ヌル文字（〇) です n 


戻り 值 I 正常終了の場合は〇を返します。 

エラーの 場合は-1を返し、 そのエラー コー ドは n - err g e t 関数で調べる こ 
とができます。 



m—t rns - 

— レベル 3 


書式 # include < music 3. h > 


int m _ trns ( c , stp )； 

int c ； /♦ チャンネル番号 （1 〜 25) */ 

int stp ； /* 音程を移調するデータ （0 〜 48> */ 


應 能」 指定のチャンネルの音程をシフトします。（半音ステップ：士 2 oct ) 

デフォルト値は24です。 

c に-1または’ NAS ドを指定した場合は、全てのチャンネルに stp を設定 
します。 

stp に-1または’ NAS ドを指定した場合は、現在の設定値を返します。 


戻り値 正常終了の埸合は0を返します。 

エラーの場合は-丨を返し、そのエラーコードは nurrget 関数で調べるこ 
とができます。 

stp に -1 または’ NASI ’ を指定した場合は、現在の設定値を返します。 


m use 


A 式 #inc 丨 use < music 3. h > 


int m _ use ( t ); 

int t ； /* トラック番号 （1 〜 80> */ 


機 JU 指定のトラックバッファの使用容量を返します。 

t に-1または’ NASI ’ を指定した場合は、全てのトラックバッファの合計 
使用容量を返します。 


I 戻り值 I 正常終了の場合は〇を返します。 

エラーの場合は-1を返し、そのエラーコードは m - errget 関数で調べるこ 
とができます。 

t に-1または’ NASI ’ を指定した場合は、全てのトラックバッファの合計 
使用容量を返します。 
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int m . vel ( c , vel )； 

int c ； /* チャンネル番号 （1 〜 25> */ 
int vel ；/* ベロシティデータ （0 〜127) */ 

8S JSJ 指定のチャンネルのベロシティを設定します。 

c に-1または’ NAS ドを指定した場合は、全てのチャンネルに vel を設 
定します。 

ve ! に-1または’ NAS ドを指定した場合は、現在の設定値を返します。 



正常終了の場合は0を返します。 

エラーの場合は-丨を返し、そのエラーコードは m _ errget 関数で調べるこ 
とができます。 

vel に -1 または 1 AS 1’ を指定した場合は、現在の設定値を返します。 


m version 


レベル3 



ンと作成日付を返しま 



ージョン （BCD 


み成年月日 


(BCD) 


ジョン 1.0 1992年3月3日作成 


ヨンと作成日付を返します。 



m_vge t - 

- レベル 3 


M 式 #include < music . h > 


int m _ vget ( vo , ca >; 

char vo ； /* 音色番号 （1 〜20 0) */ 

char * ca ； /* 音色データを格納するファの先頭アトーレス （55 バイト）*/ 

« 能 i FM 音源の音色データを取得します。 

音色データを ca に読み込みます。 


H 偵 正常終了の場合は0を返します。 

エラーの場合は-1を返し、そのエラーコードは m - errget 関数で調べるこ 
とができます。 


| #照関数 


m vset 


m vo I- 

レベル 3 



•include < music 3. h > 
nt m . vo 1( c , vol )； 

nt c ； /* チャンネル番号 U 〜 25> */ 
nt vol ； /* ボリュームデータ （0 〜127) */ 



指定のチャンネル c にボリューム vol を設定します。 

c に-1または’ NAS ドを指定した場合は、全てのチャンネルに vol を設 
定します。 

vol に-1または’ NASr を指定した場合は、現在の設定値を返します„ 


戻り偵 正常終了の場合は0を返します。 

エラーの場合は-1を返し、そのエラーコードは iD _ errg e t 関数で調べるこ 
とができます。 

vol に -1 または’ NAS ドを指定した場合は、現在の設定値を返します。 


「参照関数 I 


m mstvol 



m—vo I f It - 

レベル 3 


書 ^_#include <music3.h> 

int m.volfIt(c,md )； 

int c ； /* チャンネル番号 （1 〜 25> */ 

int md ； /* フィルタモード*/ 

« 劈」 MML データ内のボリューム設定 コマン ドを、指定チャンネルの 

演奏時に出力するかどうかを選択します。 
md に 0 を指定した場合、フィルタをオフします。 
md に 1 を指定した場合、フィルタをオンします。 

c に- 1 または’ NASI’ を指定した場合は、全てのチャンネルに ra d を設定 
します。 

md に- 1 または’ NASI’ を指定した場合は、現在の設定値を返します。 


戻り 値 正常終了の場合は〇を返します。 

エラーの 場合は-1を返し、 そのエラーコー ドは m — errget 関数で調べる こ 
とができます。 

md に-1または ’ NASI ’ を指定した場合は、現在の設定値を返します。 

I 參照阅数， m_panf 1 1, m.pgmf 11 
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m - vset - ^ 


咨式 #include < music . h > 


int m . vset ( vo , ca )； 

char vo ； /* 音色番号 U 〜200) */ 

char * ca ； /* 音色データの先頭アドレス （55 バイト）*/ 


» 能 j FM 音源の音色を設定します。 

音色データのデータ形式 



0 

1〜4(才へ•い 

■9) 

0 

フイードバック/アルゴリズム<0〜63> 

A R 

(0 〜 31) 

I 

スロットマスク 

(0 〜 15) 

D 1 R 

(0 〜 31) 

2 

ウェーブフォーム 

(0 〜 3> 

D 2 R 

(0 〜 31) 

3 

シンクロ 

(0,1) 

R R 

<0〜15> 

4 

スピード 

(0 〜255) 

D 1 L 

(0 〜15> 

5: 

PM D 

(0 〜127〉 

T L 

<0〜 127) 

6 

AMD 

(0 〜 7) 

K S 

(0 〜 3) 

7 

PMS 

<0〜3> 

MU L 

<0〜 15) 

8 

AMS 

<0〜3> 

DTI 

(0 〜7> 

9 

L , R P AN 

(0 〜3> 

DT 2 

(0 〜 3) 

10 



AM S イネーブル（0,1〉 


なお、オペレータ1は Ml (モジュレータ 1) 、オペレータ2は C 1 (キャリ 
ア 1) 、オペレータ3は M 2 (モジュレータ 2) 、およびオペレータ4は C 2 
(キャリア 2) に対応しています。 


H 倩1 正常終了の場合は0を返します。 

エラーの場合は-1を返し、そのエラーコードは m _ err get 関数で調べる 
とができます。 


参照間数 


m_vget 









m_ycom 


レベル 3 


書式 # include < music 3 - h > 


int m _ ycom ( md >; 

int md ； /* Y コマンドの使用モード*/ 

i m m \ md =0 で Y コマンドを MI D I のコントロールデータと解釈します。 

md = l で Y コマンドを0 PM レジスタの書き換えと解釈します。 
md に-1または’ NAS ドを指定した場合は、現在のモードを返します。 
(デフオルト =1) 


正常終了の場合は〇を返します。 

エラーの場合は-丨を返し、そのエラーコードは n _ errget 関数で調べるこ 
とができます。 

md に-丨または’ NAS ドを指定した場合は、現在のモードを返します。 

(デフオルト=1> 




名前 

.ALLOC 
.ANT0FF 
.ASSIGN 
.ATOI 
.BEND 
CHAN 
.CONT 
CTRLRES 
-D1R0UT 
ENABLE 
.END 
.FREE 
.FREEA 
.IFCHK 
.INIT 
MDREG 
MEAS 
.METER 
I MOD 
I NODSNS 
I.MSTVOL 
LNTOFF 
LNTON 
I OPMEXC 
I.OPMLFQ 
LOPMREG 
LOUT 
I.PAN 
I PANFLT 
I PCMBSY 
I PCMGET 
I PCMLEN 
I PCMON 
I PCMREC 
l-PCMSET 
I PGMFLT 
I.PLAY 
I.PNMGET 
LPN'MSET 
I PROG 
LSNDSET 
し START 
し STAT 
し STOP 
し SYNC 


l 指定トラックのトラックバッファの確保 
I 指定チャンネルへオールノー トオフ出力 
,トラックを指定 

指定トラックバッファの先頭アドレス取得 
指定チャンネルのビッチベンド設定 
出カチャンネルの一時変更 
指定チャンネルの演奏再開 
指定チャンネルへ各種のオフ出力 
MIDI データの出力 
指定チャンネルの発音許可 
停止小節の設定 

指定トラックバッファの残りバイト数の取得 

ド ラィ 〆 起動時の卜) い，フ7 全バイト数を取得 

MIDI インターフェイスの有無を検出 

トラックバッファの初期化 

MIDI 制御 I C のレジスタに値をセット 

演奏中の小節番号取得 

曲の拍子設定 

指定チャンネルのモジユレーシヨン設定 
FM 音源のモジユレーシヨンの深さ設定 
マスターボリユームの設定 
指定チャンネルへノー トオフの出力 
指定チャンネルへノー トオンの出力 
FM 音源のパラメータセットの選択 
FM 音源の L F 0発振周波数の設定 
指定の0 PM レジスタに値をセット 
1バイトデータを M I D I へ出力 
指定チャンネルのパンボット設定 
コマンドのモードの指定 
PCM の実行状態取得 
登録されている P CM データの取得 
指定の P CM データの取得 
指定の P CM データを再生 
外部入力音の録音 
指定の音程に PCM 音を登録 
MML 音色切り替えコマンドの出力選択 
指定チャンネルの演奏開始 
PCM 音色名の取得 
PCM 音色名の登録 
指定チャンネルの音色番号設定 
SN D ファイルのデータを FM 音源用に登録 
演奏開始小節の設定 

指定チャンネルの現在の演奏状態を返す 
指定チャンネルの演奏停止 
同期モード設定 


94 

107 

9 〇 

00 

27 

01 

on 

22 

U 7 

08 

17 

98 

14 

14 
93 

24 

15 
11 

27 

17 
26 
09 
08 

28 

29 
23 

15 
04 
32 
20 
19 
19 
21 

18 
12 

30 

98 
26 

25 
02 
11 

16 

99 
99 

110 


番号 


べツト M ) 


•10 I 0 CS コ-ルー覧 



182CBOBD9 

010041031 

$$$$$$$$$ 


57FEOF 21664 CB78E03BB9AC8A 98321949 AO 
3027^033 9^ 434114433143333324044123002 

^^$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ 





$2B 
$05 
$41 
$40 
'$06 
$15 
$0 F 
$14 
$5 E 
$03 
$12 
$4 A 
$04 
$33 


M.SYSCH 

M TEMPO 

M.TNMGET 

M TNMSET 

M TRK 

M.TRNS 

M.USE 

M.VEL 

M VERSION 

M.VGET 

M.VOL 

M.VOLFLT 

M.VSET 

M.YCOM 


チャンネル番号の割り当て変更 

曲のテンポを指定 

FM 音源の音色名の取得 

FM 音源の音色名の登録 

指定トラックに MML データをセット 

指定チャンネルの音程シフト 

指定トラックバッファの使用容 M の取得 

指定チャンネルのベロシティ設定 

0 PMDRV 3 .X のバージョンと作成□付の取得 

FM 音源の g 色データの取得 

指定チャンネルのボリューム設定 

MML ボリ 1 ーム設定コマンドの出力選択 

FM 音源の音色を設定 

Y コマンドの解釈 


97 

125 

124 

97 

10B 


105 

133 

95 
103 
131 

96 
116 






1.11 IOCS コールリフアレンス 


r C compiler PR 0-68 K v e r 2 .1 J では、 0 PMDRV 3. 父に 
より FM 音源 / MI D I/A DP CM を同時に制御できます。 

また、次のように I OCS コールを利用してアセンブラからその機能を利用すること 
も可能です。 


m 〇 v e q . 1 # OPM コール番号， D 1 

moveq . 1 # $ F 0 , DO 

trap #15 

(0 PMDR V 3. X 用の I OCS コール番号は全て $ F 0 です。） 


例）ト ラックデータの 初期化 

move.w #$01, D2 

moveq. 1 #$00, D1 

moveq.I #$F0,DO 

trap #15 


または、マクロを使用して 


include iocscaI I.mac 


move, w #1,D2 

moveq.i #.M.INIT 
IOCS .0PMDRV 


I ◦CS コールの詳細説明は、「ブログラマーズマニュアル第3章 I OCS コール」 
を参照してください。 
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籲 OPM コール番号 ：$00 OPM コマンド 


(In) 



ラックバッファの初期化 



リターン 


DO . L $ F 0 IOCS コール番号 

Dl.L $00 0 PM コール番号 

D 2 .W 初期化モード 

DO . L エラーコード 

DO . L =0. 正常終了 

現在のトラックデータを全てクリアし、各トラックバッファを4バイ 
卜に設定します。 

また、各チャンネルのパラメータは、以下のように初期化されます。 



入力の D 2. W は、音色データの初期化モードです。 

D 2. W に0を指定し場合は、音色データを初期化ぜず、1の場合は初 
期化します。 

リターンの DO . L のエラーコードについては、「1.13エラーコー 
ドー轚 J を参照してください。 


号 

番 

;u 

ネ 期 
ン 7 4 〇同 
ヤ 4 4 2 4/23 
チ1661241内 


ズ 

号 I 
番ムトィボ ド 
ク号ーッテス ー 
ッ番ユポシンボモ 
ラ色リンロラ子ン期 
卜音ボパべ卜拍テ同 
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「 M - ALL0C -- 

• OPM コール 番号 ： $01 OPM コマンド (M t , s > 


機 



入 

力 


リタ 

ーン 


解 

説 


指定トラックのトラックバッファの設定 

DO . L $ F 0 IOC S コール 番号 

Dl.L $01 OPM コール番号 

D 2. L トラック番号 X 65536 + バッファサイズ 

DO . L エラーコード 

DO . L =0. 正常終了 

指定のトラックのバッファサイズを設定します。 

全トラックバッファ内のデータは、クリアされます。 

なお、総トラックのバッファサイズ（それぞれのトラックに割り当て 
られているトラックバッファの総合計）は、 CONFIG . SYS フ 
ァイル内の ◦ PMDRV 3. X の後に指定して、再度システム起動す 
ることにより変更できます。 

DEVICE =¥ SYS ¥0 PHDRV 3 .X tnnn 

(nnn :総トラックバッファサイズ[単位： K B ]) 

入力の D 2. しは、上位16ビットがトラック番号 （1 〜 80) 、下位16 
ビットがバッファサイズ （1 〜 65535) です。 

バッファサイズは、バイト数で指定し、1〜3を指定した場合でも4 
バイト確保します。 

リターンの DO . L のエラーコードについては、「1.13エラーコー 
ドー覧」を参照してください。 
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「 M - ASSIGN 

® OPM コール 番号 ：$02 OPM コマンド ： （A c ， t ) 


機 

能 

指定チャンネルのトラック指定 

入 

力 

DO . L 

$ F 0 IOC S コール 番号 



DLL 

$02 O PM コール 番号 



D 2. L 

チャンネル番号 XS 5536 + トラック番号 

| U 夕 

—ン 

DO . L 

エラーコード 



DO . L =0 - 

•……正常終了 


解 説 1 指定のチャンネルで使用するトラックを設定します。 

1 複数のチャンネルに同一のトラックを割りあてると、それぞれ同じ楽 

譜データを演奏します。 

また、複数のトラックを1つのチャンネルに割りあてると、通も新し 
く割りふられたトラックの楽譜データを演奏します。 

デフォルト値は、チャンネル1〜2 5が、それぞれトラック1〜2 5 
に対応します。 

入力の D 2. しは、上位16ビットがチャンネル番号 （1 〜 25) 、下位 
16ビットがトラック番号 （1 〜 80) です。 

リターンの DO . L のエラーコードに ついては、「し13 エラーコー 
ドー 1 KJ を#照してください。 


「 M - VGET . — ~ : 
• OPM コール 番号 ：$03 OPM コマンド： なし 



リターン 


解 説 


FM 音源の音色データ取得 

DO . L $ F 0 IOCS コール番号 

Dl.L $03 OPM コール番号 

D 2. L 音色番号 （丨〜200〉 

Al.L 音色データを格納するためのバッファ先頭アドレス 

DO . L エラーコード 

DO . L =0 . 正常終了 

( A 1) 音色データ 

FM 音源の指定した音色番号のデータをバッファにセットします。 
入力の D 2. L は、音色番号で1〜6 8は登録済です。 

入力の A 1. しは、音色データを格納するためのバッファ先頭アドレス 
でバッファサイズは5 5バイト必要です。 

なお、音色データの内部形式は、 M _ VSET を参照してください。 
リターンの DO . L の エラーコードに ついては、「1.13 エラーコー 
ドー覧」を参照してください。 
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A R 
DIR 
D 2 R 
R R 
D 1 L 
TL 
K S 
MU I 
DTI 
DT 2 


(0 
(0 
(0 
(0 
(0 
(0 へ 


-31) 

-31) 

-31) 

-15) 

-15) 

127) 


(0 〜 3> 
<0 〜 15> 
(0 〜 7) 
(0 〜 3> 
AM S イ ネーブル （0,1> 


なお、オペレータ 1 は Ml (モジュレータ丨）、オペレータ2は C 1 (キャリ 
ア 1) 、オペレータ3は M 2 (モジュレータ 2) 、およびオペレータ4は C 2 
(キャリア 2) に対応しています。 

リターンの DO . L の エラーコードに ついては、 「1.13エラーコー 
ドー覧 J を参照してください。 


M VSET 



〇 PM 3 —ル番号 


$04 


O P M コマンド 


(V nl , n 2, data ..) 


能 


FM 音源の音色を設定 


入 力 


D 0 

D 1 

D 2 

A 1 


リターン 


D 0 


L 


DO . L =0 


^ • 


$ F 0 I OCS コール番号 

$04 0 PM コール番号 

音色番号 （1 〜200) 

音色データの先頭アドレス （55 バイト） 

エラーコード 

…正常終了 


解 説 


FM 音源の指定した音色番号に音色データを設定します。 
入力の D 2. L は、音色番号で1〜6 8は登録済です。 
入力の A 1. L は、音色データの先頭アドレスです。 
サイズは5 5バイトで、設定内容は次の通りです。 

音色データの内部形式 


0 


4<1 V い夕) 


I , t t ^ 9 

m 

O O ( 
f \ /f\ 

ム 

ズ 


VI/ \/ \/ \l/ \i/ \7 V)/ 

15 7 7 3 3 3 
0 ’25 12M M 

( ^ ^ 〇 〇 〇 〇 
一 一 /IV ^|\ /(V /V 

〇 〇 
yl\ y—v 


ゴ 

;u 

r; 

\ム 
クク| 
ツスオ 
パマフ 
ドトブロ 


N 

A 

P 


ーツーク | DDSSR 
ィロエンビ MMMM , 
フスウシス PAPAL 
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「 M TEMPO _ 

1 - _ 

• OPM コール番号 ：$05 OPM コマンド： （0 n > 
機 能 n 曲のテンポを指定 


入 力 DO . L $ F 0 IOCS コール番号 

Dl.L $05 OPM コール番号 

D 2. L テンポデータ （20 〜300) 

リターン | D 2. L =— 1: 

DO . L 現在のテンポ 

D 2. L 芒一1: 

DO . L エラーコード 

DO . L =0 ………正常終了 

|解 j 丨 FM 音源および MI D I の演奏時のテンポを指定します。 

入力の D 2. しは、テンポで1分間に4分音符をいくつ演奏できるかで 
指定します。 

デフオルトは12 0です。 

一1を指定した場合は、現在のテンポを返します。 

リターンの DO . L のエラーコードについては、「1.13エラーコー 
ドー覧」を参照してください。 


「 M - TRK - - ■■■_■- 
♦ OPM コール番号 $06 OPM コマンド ： <T n > 



リターン 


解 M 


指定トラックに MML データをセット 


DO . L $ F 0 IOCS コール番号 

Dl.L $06 0 PM コール番号 

D 2. L トラック番号（丨〜80> 

Al.L MML データ先頭アドレス 

DO . L エラーコード 

DO . L =0 ………正常終了 


指定のトラックへ MML データをセットします。 

入力の Al . L は M ML データの先頭アドレスで、終端はヌル文字 （0) 
です。 

リターンの DO . L のエラーコードについては、「1.13エラーコー 
ドー覧」を参照してください。 
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「 IFREE -- 

• OPM コール番号 ：$07 OPM コマンド：なし 


機 

能 


入 

力 


指定トラックバッファの残りバイト数の取得 

DO . L $ F 0 IOCS コール番号 

Dl.L $07 OPM コール番号 

D 2. L トラッ ク No . (1 〜80> 


リターン DO . L 残りバイト数 


解 説 指定のトラックバッファの残りバイト数を返します。 


「 M - PLAY 

• OPM コール番号：$08 OPM コマンド： （ Pnl , n 2,...> 


:« 

能 

指定チャンネルの演奏開始 

入 

力 

DO . L $ F 0 IOC S コール番号 

Dl.L $08 0 PM コール番号 

D 2. L チヤンネルのビツトパターン 

リタ 

ーン 

DO . L エラーコード 

DO . L =0 •……正常終了 

解 


指定のチャンネルの演奏を開始します。 


入力の D 2. しは、演奏の開始を指定するチャンネルのビットパターン 
で、ビット〇〜2 4がチャンネル1〜2 5に対応しており、演奏を開 
始したいチャンネルに対応したビットに1を指定します（他のビット 
は常に 0) 。 

一 1を指定した場合は、全てのチャンネルの演奏を開始します。 
リターンの DO . L の エラーコードについては、 「1.13 エラーコー 
ド ー覧 J を参照してく ださい。 





「 M STAT - 

「 — _ 

• OPM コール番号 ： $09 OPM コマンド ： なし 
厂指定チャンネルの現在の演奏状態を返す 


入力 DO . L $ F 0 IOCS コール 番号 

Dl.L $09 0 PM コール番号 

D 2. L チャンネル番号 （1 〜25> 

リターン1 D 2. L =1〜25 : 

DO . L =0 . 停止中 

DO . L =1. 演奏中 

D 2. L =-1 : 

DO . L 演奏状態を示すチャンネルのビットパターン 

解説」 指定のチャンネルの現在の演奏状態を返します。 

入力の D 2. L に一1を指定した場合は、全てのチャンネルの演奏状態 
をビットパターンで返します。 

ビット〇〜2 4がチャンネル1〜2 5に対応しており、チャンネルに 
対応したビットに演奏状態をセツトします（他のビットは常に 0) 。 


-M—STOP - 

❿ OPM コール番号 ：$0 A OPM コマンド ： （ Snl , n 2,."> 


機 能 指定チャンネルの 演奏停止 


入 力 J DO . L 

DLL 
D 2. L 

リターン] DO . L 

DO . L =0 


$ F 0 IOC S コール 番号 
$0 A O PM コール 番号 

チャンネルのビットハ•ターン 

エラーコード 

…•正常終了 


m M 指定されたチャンネルの演奏を停止します。 

入力の D 2. しは、演奏の停止を指定するチャンネルのビットパターン 
で、ビット〇〜2 4がチャンネル1〜2 5に対応しており、演奏を停 
止させたいチャンネルに対応したビットに1を指定します（他のビッ 
卜は常に 0) 。 

一 1を指定した場合は、全てのチャンネルを停止。 

リターンの DO . L のエラーコー ドについては、「1 • 13 エラーコー 
ドー覧」を参照してください。 
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r M - C0NT 


癱 OPM コール番号 ： SOB OPM コマンド： （ C > 


機 

能 

指定チャンネルの演奏再開 





入 

力 

DO . L 

$ F 0 IOC S コール番号 



DLL 

$0 B 0 PM コール番号 



D 2. L 

チヤンネルのビツトパターン 

リタ- 

-ン 

DO . L 

エラーコード 



DO . L =0 - 

•……正常終了 

解 

説 

指定されたチャンネルの演奏を再開します。 


入力の D 2. しは、演奏の再開を指定するチャンネルのビットパターン 
で、ビット〇〜2 4がチャンネル1〜2 5に対応しており、演奏を再 
開させたいチャンネルに対応したビットに1を指定します（他のビッ 
卜は常に 0) 。 

一 1を指定した場合は、全てのチャンネルを再開。 

リターンの DO . L の エラーコードに ついては、 • 「1 • 13 エラーコー 
ドー覧 J を参照してください。 


「哪 1 - 

• OPM コール番号 ： $0 C OPM コマンド：なし 


機 能 

入 力 


リターン 


指定トラックバッファの先頭アドレス取得 

DO . L $ F 0 IOC S コール 番号 

Dl.L $0 C OPM コール 番号 

D 2. L トラック番号 （1 〜 80) 

DO . L トラックバ ッファ 先頭アドレス 


解 説 指定のトラックのトラックバッファ先頭アドレスを返します。 

トラックバッファは、 0 PMDRV 3. X の内部バッファのため、 
スーパーバイザー領域です。 

データのアクセスには、注意してください。 
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春 OPM コール番号 ： $0 F OPM コマンド ： なし 


機 

能 


入 

力 


リタ- 

-ン 


解 

説 


指定トラックバッファの使用容量の取得 

DO . L $ F 0 IOC S コール 番号 

Dl.L $0 F 0 PM コール番号 

D 2. L トラック番号 （1 〜 80> 

DO . L バッファ使用容量 

指定のトラックバッファにおける現在の使用容量を返します。 

入力の D 2. L に0を指定した場合は、8 0トラック全ての合計使用容 
横を返します。 


「 M - CHAN 

• OPM コール番号 ： $10 OPM コマンド ： (N c , c ) 


機 

能 


入 

力 


リターン 


解 説 


出カチャンネルの一時変更 

DO . L $ F 0 I OCS コール番号 

Dl.L $10 0 PM コール番号 

D 2. L チャンネル番号 X 65536 + 出カチャンネル番号 

D 2. W=-l : 

DO . L 現在の出カチャンネル番号 
D 2. W^-l : 

DO . L エラーコード 

DO . L =0. 正常終了 

指定のチャンネルの出カチャンネルを一時的に変更します。 

MM L データの @ N とは異なり、変更前のチャンネルの各パラメータ 
(トラック番号、音色番号、ボリュームなど）を引き継ぎます。 

入力の D 2. しは、上位16ビットがチャンネル番号 （1 〜 25) 、下位 
16ビットが出カチャンネル番号 （1 〜 25) です。 

出カチャンネルに 一 1を指定した場合は、現在の設定値を返します。 
リターンの DO . L のエラーコードについては、「1.13エラーコー 
ドー覧」を参照してください。 
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「 M - PRQG 

• OPM コール番号 •• $11 OPM コマンド ： (G c , n ) 



リターン 


解説 


指定チャンネルの音色番号設定 

DO . L $ F 0 IOC S コール 番号 

Dl.L $11 0 PM コール 番号 

D 2. L チャンネル番号 X 65536 + 音色番号 

D 2. W=-l : 

DO . L 現在の音色番号 
D 2 .W 关 -1 : 

DO . L エラーコード 

DO . L =0. 正常終了 

指定のチャンネルの音色番号を設定します。 

入力の D 2. しは、上位16ビットがチャンネル番号 （1 〜 25) 、下位 
16ビットが音色番号（ド\1音源は1〜200 、 M I D I は1〜 128) です。 
チャンネル番号に一1を指定した場合は、全てのチャンネルに同じ音 
色番号を設定します。 

音色番号に 一 1を指定した場合は、現在の設定値を返します。 
リターンの DO . L のエラーコードについては、「1.13エラーコー 
ドー KJ を参照してください。 
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• OPM コール番号 ： $12 OPM コマンド ： (L c , n ) 



指定チャンネルのボリューム設定 

DO . L $ F 0 IOC S コール番号 

Dl.L $12 0 PM コール番号 

D 2. L チャンネル番号 X 65536 + ボリュームデータ 



D 2. W=-l : 

DO . L 現在のボリユーム 
D 2 .W 芒-1 : 

DO . L エラーコード 

DO . L =0. 正常終了 


解 説 指定のチャンネルにボリュームデータを設定します。 

入力の D 2. しは、上位16ビットがチャンネル番号 （1 〜 25) 、下位 
16ビットがボリュームデータ （0 〜 127) です。 

チャンネル番号に一1を指定した場合は、全てのチャンネルに同じボ 
リ ューム データを設定します。 

ボリュームデータに一1を指定した場合は、現在の設定値を返します。 
リターンの DO . L のエラーコードについては、「1.13エラーコー 
ドー览 J を参照してください。 
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争 OPM コール番号 ：$13 OPM コマンド ： (B c , n ) 

指定チャンネルのパンボット設定 

入 力| DO . L $ F 0 IOCS コール 番号 

Dl.L $13 0 PM コール 番号 

D 2. L チャンネル番号 X 65536 + パンポットデータ 

D 2. W=-l : 

DO . L 現在のパンポットデータ 
D 2. W 其-丨 : 

DO . L エラーコード 

DO . L =0 ………正常終了 

指定のチャンネルのパンボットデータを設定します。 

入力の D 2. しは、上位16ビットがチャンネル番号 （1 〜 25) 、下位 
16ビットがパンボットデータ （0 〜 127) です。 

チャンネル番号に一1を指定した場合は、全てのチャンネルに同じパ 
ンボットデータを設定します。 

パンボットデータのデフォルト値は6 4です。 

パンボットデータに一1を指定した場合は、現在の設定値を返します。 

パンボットデータ 

〇 •• ライト（右端） 

6 4:センター（中央） 

12 7:レフト（左端） 

リターンの DO . L のエラーコードに ついては、「1.13 エラーコー 
ドー覧 J を参照してください。 
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鲁〇 PM コール番号 ：$14 OPM コマンド ： (U c , n ) 






指定チャンネルのベロシティを設定 

DO . L $ F 0 IOC S コール番号 

Dl.L $14 0 PM コール番号 

D 2. L チャンネル番号 X 65536 + ベロシティデータ 

D 2. W=-l : 

DO . L 現在のベロシティデータ 
D 2 .W 芒-1 : 

DO . L エラーコード 

DO . L =0. 正常終了 

指定のチャンネルのベロシティデータを設定します。 

入力の D 2. しは、上位16ビットがチャンネル番号 （1 〜 25) 、下位 
16ビットがベロシティデータ （0 〜 127) です。 

チャンネル番号に一1を指定した場合は、全てのチャンネルに同じべ 
ロシティデータを設定します。 

ベロシティデータのデフォルト値は12 7です。 

ベロシティデータに 一 1を指定した場合は、現在の設定値を返します。 
リターンの DO . L のエラーコードについては、「1.13エラー コー 
ドー覧」を参照してください。 
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「 M - TRNS - 

« OPM コール番号 ：$15 OPM コマンド ： (R c , n ) 


機 

能 


入 

力 


指定チャンネルの音程シフト 

DO . L $ F 0 IOC S コール番号 

Dl.L $15 0 PM コール番号 

D 2. L チャンネル番号 X 65536+ トランスポーズデータ 


リターン D 2. W=-l : 

DO . L 現在のトランスポーズデータ 
D 2 .W 弇 -1 : 

DO . L エラーコード 

DO . L =0 正常終了 


解 説 指定のチャンネルの音程を土 2オクターブの範囲でシフトします。 

入力の D 2. しは、上位16ビットがチャンネル番号 （1 〜 25) 、下位 
16ビットがトランスポーズデータ （0 〜 48) です。 

チャンネル番号に 一 1を指定した場合は、全てのチャンネルに同じ卜 
ランスポーズデータを設定します。 

トランスポーズデータのデフォルト値は6 4です。 

トランスポーズデータに一1を指定した場合は、現在の設定値を返し 
ます。 

リターンの DO . L のエラーコードについては、 「1.13 エラーコー 
ドー轚 J を参照してください。 
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「 M ANTOFF - 

I - _ ； _ 

# OPM コール番号 ： $18 OPM コマンド （J c ) 

機 能 指定チャンネルへオールノー トオフ出力 


入 

力1 

DO . L 

$ F 0 IOCS コール番号 



D 1 .L 

D 2. L 

$18 0 PM コール番号 

チャンネル番号 （1 〜 25) 

リタ 

—ン 

DO . L 

エラーコード 



DO . L =0 •… 

a 

…•-正常終了 

解 

説 

指定のチャンネルへオールノー トオフを出力します。 



入力の D 2. しに 
フを出力します 

一 1を指定した場合は、全てのチャンネルへノートオ 

1 

〇 


リターンの DO . L のエラーコードについては、 
ドー贅 J を参照してください。 


1 . 


3 エラーコー 


r M - D1RQUT —— 

參 OPM コール番号 ：$19 OPM コマンド ：(X nl , n 2... n 512) 



リターン 


解説 


MIDI データの出力 


DO . L $ F 0 IOCS コール番号 

Dl.L $19 0 PM コール番号 

D 2. L データサイズ 

Al.L MIDI データの先頭アドレス 

DO . L エラーコード 

DO . L =0. 正常終了 


MIDI データをデータサイズ分 M I D I へ出力します。 

リターンの DO . L のエラーコードについては、「1.13エラーコー 
ドー覧 J を参照してください。 
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• OPM コール 番号 ： $1 A OPM コマンド ： （ Efil , n 2...> 

指定チャンネルの発音許可 

DO . L $ F 0 IOCS コール番号 

Dl.L $1 A 0 PM コール番号 

D 2. L チャンネルのビツトパターン 

D 2. L =-1 : 

DO . L 現在の許可状態を示すチャンネルのビットパターン 
D 2. L 芒- 1 : 

DO . L エラーコード 

DO . L =0 . 正常終了 

解 — ^__| チャンネルのビットパターンで示されるチャンネルの演奏を、許可 

(ビット=丨）または禁止（ビット=〇)します。 

M _ ST 0 P とは異なり、内部的にはノー ト以外のデータは、継続しれてい 
ます（ミュート状態）。 

入力の D 2. しは、発音許可を指定するチャンネルのビットパターンで、 
ビット〇〜2 4がチャンネル1〜2 5に対応しており、発音を許可し 
たいチャンネルに対応したビットに1を指定します（他のビットは常 
に 0) 〇 

一 1を指定した場合は、現在の許可状態を示すチャンネルのビットパ 
ターンを返します。 

リターンの DO . L のエラーコードについては、「1.13エラーコー 
ドー KJ を参照してください。 






M NT0N 


OPM コール番号 


$1 B OPM コマンド 


なし 


a 



指定チヤンネルへノー トオン出力 




DO . L $ F 0 IOC S コール番号 

Dl.L $1 B 0 PM コール番号 

D 2. L チャンネル番号 X 65536+ ノー ト番号 X 256+ V 13 シ hr - 夕 

DO . L エラーコード 

DO . L =0. 正常終了 

指定のチャンネルへノー トオンを出力します。 

入力の D 2. L は、上位16ビットがチャンネル番号 <1〜25>、ビット8〜 
15がノー ト番号 (0 〜127)、下位8ビットがべ ロ シティ （0 〜127)です。 
リターンの DO . L の エラーコードに ついては、「1.13 エラーコー 
ドー覧 J を参照してください。 
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「柳 FF — 

• OPM コール番号 ： SIC OPM コマンド ： なし 



指定チャンネルへノー トオフ出力 

DO . L $ F 0 IOC S コール番号 

Dl.L $1 C 0 PM コール番号 

D 2. L チャン お l 番号 X 65536+ ノー ト番号 X 256 +Vn シティ r -夕 


リターン 


DO . L エラーコード 

DO . L =0. 正常終了 


解説 指定のチャンネルへノー トオフを出力します。 

入力の D 2. しは、上位16ビットがチャンネル番号（1〜25)、ビット 
8〜15がノー ト番号 （0 〜 127) 、下位8ビットがベロシティ （0 〜 127) 
です。 

リターンの DO . L のエラーコードに ついては、「1.13 エラーコー 
ドー覧 J を参照してください。 
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「 M - SYNC … . 

• OPM コール番号 ：$20 OPM コマンド ： （Z n > 


機 

能 


入 

力1 


リターン 


1 解説 


同期モード設定 


DO . L $ F 0 I OCS コール番号 

Dl.L $20 OPM コール番号 

D 2. W 间期モード 

D 2. W=-l : 

DO . L 現在の同期モード 
D 2. W^-l : 

DO . I エラーコード 

DO . L - J ………正常終了 

MIDI クロック同期モードを設定します。 

入力の D 2. W は同期モードで、設定内容は次の通りです。 

D 2. W = 0 . 内部の M I D I クロックに合わせて演奏 

=1 . 外部の MI D I クロックに合わせて演奏 

= 2 . 外部の F S K クロックに合わせて演奏 

=一1 . 現在の状態を DO . L に返します。 

外部同期にする場合は、同期モードに1を指定し、 M _ SYNC 実行後 
M_PLAY で待機状態にセットして M I D I の スタート コマンド （$ FA ) を 
待ちます。 

リターンの DO . L の エラーコードに ついては、 「1.13エラーコー 
ドー覧 J を参照してください。 
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「 M - METER 

# OPM コール番号 ：$21 OPM コマンド : (Q nl , n 2) 



機 能 曲の拍子設定 


入力 DO . L 

DLL 
D 2. L 



DO . L =0 


$ F 0 IOC S コール番号 

$21 0 PM コール番号 

拍子の分子 X 65536 +拍子の分母 

エラーコード 

…•正常終了 


i 解 説_| 曲の拍子を 設定し ます。 

入力の D2 I •は、 16 ビッ、が 拍子の 分ェ f! MfO 、 下位 
16ビットが 拍子の 分母 (2,4,8,16) です。 

デフォルト値は4/4泊子に設定されています。 

リターンの DO. L のエラーコードについては、 r 1 . 13 エラー; J-- 
ド- •黃 J を 参照して ください。 


— 


M SNDSET 


© OPM コール番号 


$29 O P M コマンド 




能 


SN D ファイル形式のデータを FM 音源用に登録 



リターン 


DO . L $ F 0 IOCS コール 番号 

Dl.L $29 OPM コール 番号 

D 2. L データサイズ（最大16000バイト） 

Al.L データの先頭アドレス 

なし （ DO . L の内容は保証されません） 



L 解__説 


SOUND PR 0-68 K の S N D ファイル形式のデータを F M 音源用の音 
色データとして登録します。 

入力の D 2. 乙は、データサイズで1音色8 0バイトを最大2 0 0音色 
分 （=16000 バイト）まで指定できます。 

入力の Al . L は 、 S N D ファイル形式のデータが格納されている バッ 
ファの先頭アドレスです。 

リターンの DO . L のエラーコードについては、 「1.13 エラーコー 
ドー覧」を参照してください。 
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リターンの DO . L のエラーコードについては、「1.13エラーコー 
ドー覧」を参照してください。 


M PCMSET 


OPM コール番号 


$2 A OPM コマンド 



リターン 


指定の音程に PCM 音を登録 



DO 

DI 

D 2 

D 3 

A 1 


DO 


$ F 0 IOC S コール番号 

$2 A 0 PM コール番号 

データサイズ（最大32767バイト） 

ノー ト番号 X 65536 + サンプリング周波数 
PCM データの先頭アドレス 

エラーコード 

…•正常終了 



DO . L =0. 正常終了 

指定の音程に音を登録します。使用できる音程は’ C -2’ から ’G 林8’ 
(ノー ト番号〇〜127に対応）の12 8音です。 

入力の D 2. しは、 PCM データのバイト数で一1を指定した場合は、 
PCM バッファをクリアします。 

入力の D 3. しは、上位16ビットがノー ト番号 （0 〜 127) 、下位 
16ビットがサンプリング周波数 （0 〜 4) です。 


z z z z Z 
HHHHH 
KKKKK 
92846 


数 . 

波3 571015 



リ〇12 3 4 

ブ 

ン 

サ 
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M SYSCH 



OPM コール番号 ： $2 B OPM コマンド 


チャンネル番号の割り当て変更 


(/0 MP ) 




DO . L 
DLL 
D 2. W 


$ F 0 IOC S コール番号 

$2 B 0 PM コール番号 

割り当てモード（〇〜 5) 



D 2. W=-l : 

DO . L 割り当てモード 
D 2 .W た1 : 

DO . L エラーコード 

DO . L =0. 正常終了 


解説 各音源に対するチャンネル番号の割り当てモードを設定します。 

入力の D 2. W は割り当てモードで、設定内容は次の通りです。 
割り当てモード 


0= ，， 0PM”.0PM=chl 〜8 PCM=ch9 MIDl=chlO 〜25 

1=”0MP”.0PM=chl 〜8 MlDI=ch9 〜 24 PCM=ch25 

2=”M0P”.MIDI=chl 〜 16 0PM=chl7 〜 24 PCM=ch 25 

3=”MP0”.MlDl=chl 〜 16 PCM=chl7 0PM=chl8 〜 25 

4=”P0M”.PCM=chl 0PM=ch2 〜9 MIDI=chlO 〜 25 

5=”PM0 ，， .PCM=chl MIDI=ch2 〜 17 0PM=chl8 〜 25 


入力の D 2. W が一 1 の場合は現在のモードを D 0. に返します。 
リターンの DO . L のエラーコードについては、「1.13エラーコー 
ドー覧 J を参照してください。 
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「U 隱 


籲〇 PM コール番号 ： $2 C OPM コマンド 無し 


楞 

能 

M I D I インタ 

ーフ x イスの有無を検出 

入 

力 

DO . L 

Dl.L 

$ F 0 IOC S コール番号 

$2 C 0 PM コール番号 

リタ 

ーン 

DO . L 

DO . L =0 …… 

DO . L =+"■ 

ェラーコード 
….ある 
….ない 

解 

説 

M I D I インタ 

ーフェイスの有無をチェ ッ クします。 


「 M FREEA _ 

1 一 _ 

癱 OPM コール番号 ： $2 F OPM コマンド ： 無し 

機 能1 ドライバ起動時のトラックバッファ全バイト数を取得 


人 

力 

DO . L 

D 1 .L 

$ F 0 IOC S コール番号 

$2 F 0 PM コール番号 

リタ 

ーン 

DO . L 

全トラックバッファのバイト数 


解 説 1 ドライ バ起動時に確保 したトラックバッファの全バイト数を返し 

ます。 
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籲〇 PM コール番号 $30 


OPM コマンド：無し 



1バイトのデータを MI D I へ出力 


入 力」 DO . L 

Dl.L 
D 2. B 


$ F 0 IOC S コール 番号 

$30 0 PM コール 番号 

出カ データ （0 〜 225) 



なし （ DO . L の内容は保証されません） 


1バイトデータを M I D I に出力します。 


「 M.MEAS 


争 OPM コール番号 ： $32 OPM コマンド ： 無し 


« 

能 1 

演奏中の小節番号取得 

入 

力 

DO . L 

DLL 

SFO IOCS コール番号 

$32 0 PM コール番号 

リタ 

ーン 

DO . L 

小節番号 <0〜32767) 

解 

説 

現在演奏中の小節番号を返します。 


MML データ”1:”，” D . S .” などの繰り返し記号の場合はそのまま加算 
されますので、実際の小節番号とは異なる場合があります。 
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r M - YC0M 


♦ OPM コール番号 ： $33 OPM コマンド ： (/Y n ) 


m 

能 

Y コマンドの解釈 






入 

力 

DO . 

L 

$ F 0 I OCS コール番号 



Dl . 

L 

$33 0 PM コール番号 



D 2. 

L 

使用モード 

リタ 

ーン 

D 2. 

L =-1 

• 

• 




DO . L 

現在の使用モード 



D 2. 

L 其 -1 

• 

• 




DO . L 

不定 

解 

説 

Y コマンドの使用モードを設定します。 


M _ TRK 実行前に設定してください。 

入力の D 2. L は、 Y コマンドの使用モードです。 

D 2. L に0を指定した場合は、 Y コマンドを MI DI のコントロール 
データとして解釈し、1の場合は0 PM レジスタ書き換えと解釈しま 
す。 



• OPM コール番号 ：$34 OPM コマンド ： (PN n ) 


機 

能 

演奏開始小節の設定 

入 

力 

DO . L $ F 0 IOC S コール番号 

Dl.L $34 OPM コール番号 

D 2. W 小節番号 （0 〜 32767) 

リタ， 

ーン 

DO . L エラーコード 

DO . L =0. 正常終了 

L 解 

説 

M 一 P LAY で演奏を開始する小節位置を設定します 


全てのチャンネルの MML データ”丨：，，，，， D . S . ，，，，，：丨，，，，， D.C •，，などの数 
や位置が同じでないと正常な演奏ができません。 

なお、一度設定された小節番号は、演奏が終わるとクリアされます。 
リターンの DO . L のエラーコードについては、「1.13エラーコー 
ドー覧」を参照してください。 


116 







籲 OPM コール番号 ：$35 OPM コマンド ： (SM n ) 



演奏停止小節の設定 


DO . L $ FO IOCS コール番号 

Dl.L $35 OPM コール番号 

D 2. W 小節番号 （1 〜 32767) 


リターン 


DO . L エラーコード 

DO . L =0 ………正常終了 


解説 演奏を停止する小節位置を設定します。 

全てのチャンネルの MML データ”1:”，” D . S . D . C .” などの数 

や位置が同じでないと正常な演奏ができません。 

リターンの DO . L のエラーコードに ついては、「1.13 エラーコー 
ドー覧」を参照してください。 


「 M -_ SNS - 

• OPM コール番号 ： $36 OPM コマンド：無し 


機 


能 


入 力 


リターン 


FM 音源のモジュレーションの深さ設定 

DO . L $ F 0 IOC S コール番号 

Dl.L $36 OPM コール 番号 

D 2. L モジュレーションの深さ （0 〜 127) 

D 2. W=-l : 

DO . L 現在のモジュレーションの深さ 
D 2 .W 其-1 : 

DO . L エラーコード 

DO . L =0 . 正常終了 


解説 FM 音源全体にかかるモジュレーシヨンの深さを設定します。 

入力の D 2. L は、 FM 音源のモジュレーションの深さで、一1を指定 
した場合は、現在の設定値を返します。 

リターンの DO . L のエラーコードに ついては、「1.13 エラーコー 
ドー覧」を参照してください。 
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PCMREC 


OPM コール 番号 ：$38 OPM コマンド 



外部入力音の P CM 録音 





DO . L $ F 0 IOC S コール番号 

Dl.L $38 OPM コール番号 

D 2. W サンプリング周波数 （0 〜 4) 

D 3. L バッファサイズ（最大32767バイト） 

Al.L P C M データバッファの先頭アドレス 

DO . L エラーコード 

DO . L =0. 正常終了 

DO . L =-1 . タイムオーバー 

( Al ) PCM データ 


オーデイオ入力端子より入力された音を P CM 録音し、バッファに 
セツトします。 

4秒以内に音が入力されなければ、 DO . L に一1を返します。 

録音の頭出しは自動処理されます。（音が入力された時点で録音を開 
始します。） 

入力の D 2. W はサンプリング周波数で設定内容は、次の通りです。 


サンプリング周波数 

〇 . 3. 9 K H z 

1 . 5. 2 K H z 

2 . 7 . 8 K H z 

3 .10. 4 K H z 

4 .15. 6 K H z 


( 1秒につき1950バイト） 
( 1秒につき2600バイト） 
( 1秒につき3900バイト） 
( 1秒につき5200バイト） 
( 1秒につき7800バイト） 


リターンの DO . L のエラーコードについては、「1.13エラーコー 
ド ー覧 J を参照してください。 
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M PCMGET 



OPM コール番号 ： $39 OPM コマンド 


無し 



登録されている P CM データの取得 




DO . L $ F 0 IOCS コール番号 

Dl.L $39 OPM コール番号 

D 2. W ノー ト番号 （0 〜 127) 

D 3. L バッファサイズ（バイト数） 

Al.L P CM データバッファの先頭アドレス 

DO . L 読み込まれたデータサイズ 

( Al ) PCM データ 



現在ドライバ内に登録されている指定ノー ト番号に対応する PCM 
データをバッファにセツトします。 


M PCMLEN 




現在ドライバ内に登録されている指定ノー ト番号に対応する PCM 
データのサイズを返します。 
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籲 OPM コール 番号 ： $3B OPM コマンド： 無し 
機 能 'PCM の実行状態を返す 





DO. L $F0 IOC S コール 番号 

Dl.L $3B OPM コール番号 

DO. L 実行状態 

DO. L =$00. 何も実行していない 

DO. L =$02. 出力中 （ ADPCM0UT,M-PCM0N を実行中） 

DO. L =$04. 入力中 （ ADPCM1NP,M_PCMREC を実行中 ) 

DO. L =$12 . 出力中 （ ADPCMA0T を実行中） 

DO. L =$14 . 入力中 (ADPCMAIN を実行中 ) 

DO. L =$22 . 出力中 （ ADPCML0T を実行中） 

DO. L =$24 . 入力中 (ADPCMLIN を実行中 ) 

現在の PCM の実行状態を返します。 
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音声出カモードの設定内容は、次の通りです。 

音声出カモード（オーディオ出力端子） 

1 . 左 

^2 . 产 

3 . ステレオ（左右両方） 


「 M_PCMON 


• O PM コー 

•ル番号 ： $3 C 〇 PM コマンド：無し 

機 

能 

] 指定の PCM データを再生 

入 

力 

] DO . L $ F 0 IOCS コール番号 

Dl.L $3 C 0 PM コール番号 

D 2. L ノ-卜番号 X 65536パンフ • リンデ周波数 x 256♦音声出力 t - K 

リターン 

] なし 

解 

説 

現在ドライバ内に登録されている PCM の、指定ノー ト番号に登録さ 
れているデータを再生します。 

入力の D 2. しは、上位16ビットがノー ト番号 （0 〜 127) 、ビット8 


〜15がサンプリング周波数 （0 〜 4) 下位8ビットが音声出カモード 
(1 〜 3) です。 


z z z z Z 
H H H H H 
K K K K K 
9 2 8 4 6 

数 . 

波357 1015 

周； 

グー 


リ〇12 3 4 
プ 


サ 
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• OPM コール番号 ： S 3 D OPM コマンド 無し 



指定チャンネルへ各種のオフ出力 

DO . L $ F 0 IOCS コール番号 

Dl.L $3 D 0 PM コール 番号 

D 2. W チャンネル番号 （1 〜 25) 

I リターン : DO . L エラーコード 

DO . L =0. 正常終了 

指定のチャンネルにビッチベンドオフ/モジュレ•-シヨンオフ/ダ 
ンパーオフ/オールノー トオフを出力します。 

入力の D 2. W はチ r ンネル番号 C - 丨を指定した場合は、全てのチャン 
ネルへピッチベンドオフ/モジュレーシヨンオフ/ダンパーオフ/ 
オールノー トオフを出力します。 

リターンの DO . L のエラーコードについては、「1 • 13エラーコー 
ドー轚 J を参照してください。 
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「 M -_ REG . 

• OPM コール番号 $3 E OPM コマンド ： 無し 


機 


能 指定の0 PM レジスタに値をセット 


入 

力 

DO . L 

$ F 0 IOCS コール 番号 



DLL 

$3 E 0 PM コール 番号 



D 2. W 

レジスタ番号 (0-255) 



D 3. W 

OPM へ書き込むデータ （0 〜 255) 

夕 

ーン 

D 3. W=-l 

參 

• 



DO . L 

現在のレジスタ値 



DO .1 

-=-1畲き換えられていない 



D 2. W=-l 

• 

• 


DO . L 0 PM レジスタバツファの先頭アドレス 

上記以外 ： 

DO . L エラーコード 

DO . L =0. 正常終了 


解説| 指定の0 PM レジスタに偵をセットします。 

入力の D 3. W に一1を指定した場合、指定した0 PM レジスタの値を 
返します。 

一度も指定の0 PM レジスタが害き換えられていない場合、一1を返 
します。 

D 2. W に一1を指定した場合、 ◦ PM レジスタの先頭アドレスを返し 
ます。 

0 PM レジスタバッファは各レジスタにつき2バイトずつ計512バ 
イト有り、現在までにレジスタが害き換えられてなかった場合は、そ 
のレジスタの位興に一1(ワード）がセットされています。 
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r M - MDREG 


• 0 PM コール 番号 ： $3 F 0 PM コマンド： 無し 


機 

能 


入 

力 


リターン 


解 説 


MIDI 制御 I C のレジスタに値をセット 


DO . L $ F 0 IOC S コール番号 

D 2. L グルーブ 番号 X 65536 + アドレス 番号 

DO . L エラーコード 

DO . L =0 . 正常終了 


MIDI 制御 I C ( YM 3802) のレジスタに値を害き込みます。 
入力の D 2. しは、上位16ビットがグルーブ番号 （0 〜 9) 、下位ビッ 
卜がアドレス番号 （0 〜 7) です。 


リターンの DO . L のエラーコードに ついては、 「1.13エラーコー 
ドー覧」を参照してください。 


注：間違ったパラメータを指定すると、システムが正常に動作しなく 
なる場合があります。 

YM 3802 の機能を十分に理解の上でご使用ください。 


匚 M TNMSET _ 

• OPM コール 番号 ： $40 OPM コマンド ： (/V n , naae ) 
' 機 能1 FM 音源の音色名の登録 



入—力 



解説 


DO . 

L 

$ F 0 IOC S コール番号 

D 1. 

L 

$40 O PM コール番号 

D 2. 

W 

音色番号 （1 〜 200) 

A 1. 

L 

音色名の先頭 アドレス 

DO . 

L 

エラーコード 


DO . L =0 . 正常終了 


FM 音源の音色番号で示される音色データに音色名を登録します。 
(半角で1〇文字以内） 

リターンの DO . L の エラーコードに ついては、「1.13 エラーコー 
ドー覧 J を参照してください。 
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「 M TNMGET - 

1 一 _；___ 

#OPM コール 番号 $41 OPM コマンド 無し 

i F M 音源の音色名の取得 


入力 


リターン 


解説 


DO . L $ F 0 IOC S コール番号 

Dl.L $41 0 PM コール番号 

D 2. W 音色番号 （1 〜200) 

ALL 音色名を格納するためのバツファ先頭アドレス 

DO . L エラーコード 

DO . L =0. 正常終了 

( A 1) 音色名 


FM 音源の音色番号で示される音色データに登録されている音色名 
を取得します（半角で1〇文字以内）。 

リターンの DO . L のエラーコードに ついては、「1.13 エラーコー 
ドー KJ を参照してください。 


「 M PNMSET - 

r — _ 

• OPM コール 番号 ： $42 OPM コマンド ： (/A n , naie ) 
丨機 m pcm 音色名の登録 


入 力 


u ターン 


解 説 


DO . L $ F 0 IOC S コール 番号 

Dl.L $42 0 PM コール 番号 

D 2. W ノー ト番号 （0 〜 127) 

Al.L 音色名の先頭アドレス 

DO . L エラーコード 

DO . L =0. 正常終了 


PCM のノー ト番号に音色名を登録します。（半角で10文字以内） 
リターンの DO . L のエラーコードについては、 「1.13 エラーコー 
ドー覧」を参照してください。 
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春 OP M コール 番号 : U 3 0 PM コマンド •- 無し 

PCM 音色名の取得 

DO . L $ F 0 IOC S コール番号 

Dl . L $43 OPM コール番号 

D 2. W ノー ト g 号 （C 〜12 7) 

Al.L 音色名を柃納するための バッフ ァ先頭 アドレス 

リターン1 DO . L エラーコート 

nn..K 常♦••了 

( Al ) h 色名 

pcm 穹源の# e 名を: s 得します。（半角で1〇文字以内） 

リターンの DO . L の エラーコードについては、「1.13エラーコー 
ド ー覧」 を参照して、 ださい。 






M MSTV0L 


OPM コール番号 ：$44 OPM コマンド 


マスター ボリ ュームの 設定 


(/( J ) 〜（/127> 






DO . L $ F 0 IOC S コール番号 

Dl.L $44 0 PM コール番号 

D 2. W マスターボリューム （0 〜 127) 

D 2. W =-1 : 

DO . L 現在のマスターボリューム 
D 2 .W 芒- 1 : 

DO . L エラーコード 

DO . L =0. 正常終了 

マスターボリュームを設定します（デフォルト値は 127) 。 

入力の D 2. W に一1を指定した場合は、現在の設定値を返します。 
M_INIT を実行するまで有効です。 

リターンの DO . L のエラーコードについては、「1.13エラーコー 
ドー鶩 J を参照して ください。 
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「 M—BEND - 

# OPM コール番号 ： 545 OPM コマンド 



機 1」 指迮チャンネ 

「入 力] DO . L 

Dl . L 
D 2. L 

I リターン DC . L 

DO . L 二 ( i . 


L のビッチベンド設定 

F 0 I 0 C S フール番畀 

545 0 P M コール嵆号 

チ >，ンネル番号 X « Sr >5： K ； i ビ，ナベン 

エラーコード 

…… JV 常終了 



解 説」 杞定のチャンそルにビっィ•ベンドを蹬定しま；.、 

人力の D ? •し: t 、 ヒ位！ ビットがチャン不ルが芒 M 〜 25) 、 

I 了位16ビットがピッァベンドデー々 （ u 〜! -7) て••“ 

チャンネル榊ちに一1をす ’ i 定1•たけ今は、$ C ^ -ンネ.ル.•同じ 
c ： ッチベンドデータを&定します。 

しターンの DU . T . のエラー コー ド，へついては、 r 1 • 1 ：j r •ラーコー 
ドー•览 J を参照してくたさい。 


「 M 一 _ 


0 OPM コール番号 ：$46 OPM コマンド：無し 



指定チャンネルのモジュレーシヨン設定 



入 力 


リターン 


解 M 


DO . L SFO IOC S コール番号 

Dl.L $48 0 PM コール番号 

D 2. L チャンネル番号 X 65536 + モジュレーションデータ 

DO . L エラーコード 

DO . L =0. 正常終了 

指定のチャンネルのモジュレーションを設定します。 

入力の D 2. しは、上位16ビットがチャンネル番号 （1 〜 25) 、 

下位16ビットがモジュレーションデータ （0 〜 127) です。 

チャンネル番号に一1を指定した場合は、全てのチャンネルに同じ 
モジュレーションデータを 設定します。 

リターンの DO . L の エラーコードに ついては、「1.13 エラーコー 
ド ー覧 J を参照してください。 
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「 M - QPMEXC 一 … 

• OPM コール番号 ： $47 OPM コマンド ： （/ En ) 



入 力 


U ターン 


解 説 


FM 音源のパラメータセツトの選択 


DO . L $ F 0 IOC S コール番号 

Dl.L $47 OPM コール番号 

D 2. W パラメータセットモード 


D 2. W=-l : 

DO . L 現在のパラメータセツトモード 
D 2 .W 芒-1 : 

DO . L エラーコード 

DO . L =0. 正常終了 


FM 音源にセツトする音色パメータの内、 LFQ / PMD/AMD 
などの全体に影饗するパラメータを音色切り替え時にセツトするかど 
うかを選択します。 

入力の D 2. W の設定内容は次の通りです（デフォルト値は 1) 。 


パラメータセツトモード 

0 . セツトしない 

1 . セツトする 

-1 . 現在の設定値を返す 

リターンの DO . L のエラーコードに ついては、「1.13 エラーコー 
ドー騖 J を参照してください。 
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OPMLFQ 



• OPM コール番号 ：$48 OPM コマンド ： （/ SPn > 



FM 音源の L F 0の発振周波数の設定 



$ F 0 IOC S コール番号 

$48 0 PM コール番号 


D 2. W スピードデータ （0 〜 255) 



D 2. W=-l : 

DO . L 現在のスビードデータ 
D 2 .W 芒-1 : 

DO . L エラーコード 

DO . L =0. 正常終了 



FM 音源の発振周波数を設定します。 

入力の D 2. W はスピードデータで、デフォルト値は 19 8 です。 

一 1を指定した場合は、現在の設定値を返します。 

リターンの DO . L のエラーコードに ついては、 「1.13エラーコー 
ドー KJ を参照してください。 
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「 M—P 謝 T . —— 

騫〇 PM コール番号 :$49 OPM コマンド：無し 


r m 

— i — 


1入 

力 


リターン 


MML 音色切り替えコマンドの出力選択 


DO . L $ F 0 IOCS コール 番号 

Dl.L $49 OPM コール番号 

D 2. L チヤンネル S 号 X 65536 + フイルタモード 


D 2. W =-1 : 

DO . L 現在のフィルタモード 
D 2 .W 式-1 : 

DO . L エラーコード 

DO . L =0. 正常終了 


|解 説！ MML データ内の g 色切り替えコマンド （@ n ) を、指定チャンネル 

の演奏時に出力するかどうかを選択します。 

入力の D 2. しは、上位16ビットにチャンネル番号（1〜25)、 

下位16ビットが音色切り替えコマンドのフィルタモードです。 
チャンネル番号に 一 1を指定した場合は、全てのチャンネルに同じ 
フイ ルタモードを設定します。 


フィ ルタモードの設定内容は次の通りです。 

〇 . フィルタオフ （@ n を出力する） 

1 . フィルタオン （@ n を出力しない） 

一 1 . 現在の設定値を返す 

リターンの DO . L のエラーコードについては、 r 1 • 13 エラーコー 
ド ー覧 J を参照してください。 
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r M - VQLFLT " 

參 OPM コール番号 ： S 4 A OPM コマンド：無し 


機 


M M L ボリュ 

ーム設定コマンドの出力選択 

1 A 

力 

DO . L 

$ F 0 IOC S コール番号 



DLL 

$4 A 0 PM コール番号 



D 2. L 

チヤンネル番号 X 65536 + フイ 

リタ 

—ン 

D 2. W=-l 

• 

• 


DO . L 
D 2. W 其-1 
DO . L 
DO . 


現在のフィルタモード 
エラーコード 

= 0……•…正常終了 


:解 説| MML データ内のボリューム設定コマンド （ Vn /@ Vn ) を、指定チヤ 

ンネルの演奏時に出力するかどうかを選択します。 

入力の D 2. しは、上位16ビットにチャンネル番号 （1 〜 25) 、 

下位16ビットがボリューム設定コマンドのフィルタモードです。 
チャンネル番号に一1を指定した場合は、全てのチャンネルに同じ 
フィルタモードを設定します。 


フィルタモードの設定内容は次の通りです。 

0 . フィルタオフ （ Vn / eVn を出力する） 

1 . フィルタオン （ Vn “ V n を出力しない） 

一 1 . 現在の設定値を返す 


リターンの DO . L のエラーコードについては、「1.13エラーコー 
ド ー覧 J を参照してください。 
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「 M - PANFLT 

• OPM コール番号 •• $4 B OPM コマンド •• 無し 



リターン 


解 説 


パンポット設定コマンドの出力選択 


DO . L $ F 0 IOC S コール番号 

Dl.L $4 B 0 PM コール番号 

D 2. L チャンネル番号 X 65536 + フィルタモード 


D 2. W=-l : 

DO . L 現在の フイ ルタモード 
D 2 .W 关-1 : 

DO . L エラーコード 

DO . L =0. 正常終了 


MML データ内のパンボット設定コマンド （ Pn / gPn ) を、指定チヤ 
ンネルの演奏時に出力するかどうかを選択します。 

入力の D 2. しは、上位16ビットにチャンネル番号（1〜25)、 

下位16ビットがパンボット設定コマンドのフィルタモードです。 
チャンネル番号に一1を指定した場合は、全てのチャンネルに同じ 
フイルタモードを設定します。 


フィルタモードの設定内容は次の通りです。 

0 . フィルタオフ （ Pn /@ Pn を出力する） 

1 . フィルタオン （ Pn /@ Pn を出力しない） 

一 1 . 現在の設定値を返す 

リターンの DO . L のエラーコードについては、 「1.13 エラーコー 
ドー覧 J を参照してください。 
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M VERSION 




D 15 D l 4 D 13 D 12 Dll DIO D09 D08 D07 D06 D05 D04 D03 D02 DO1 DOO 



例）バージョン 1. 0 19 9 2年3月3日作成 

$10920303 
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以下の 0 PM コマンドは、0 S 上からデバイス名 •01 M ’ または、 1 DI ’ に直接出力 
して実行する事ができます。 


貝体的には、 MML と共にアスキーファイルこして作成しておき、 
COPY くファ イル名〉 0 PM ® 

COPY くフ ァイル名〉 HIDI 01 
で実行できます。 


0 P M コマンド 

" • " ■■■ ■ ■■ ■ ■■ ■■■■ ■ ■ ■■■■■ ■■■ — ■ ■ _ —— ■ ^ 

パラメータ / 機 能 

< REM > または/ 

” < REM >” または”/”で始まる行を注釈行とみなします。 

(全角文字で始まる行も注釈とみなします。） 

(/0 PM ) 

(/0 MP ) 

(/ HOP ) 

(/ MP 0) 

(/ PM 0) 

(/ POM ) 

各音源に対するチャンネル番号の割り当てを変更します。 

ドライバ組み込み時のオブシヨンスイツチ r /0 PM '”/ P 0 M ” など）と 
同じ機能です。 

:0 PM = chl 〜8 PCM = ch 9 MlDl = chlO 〜25 

:0 PM = chl 〜 8 MlDl = ch 9 〜 24 PCM = ch 25 

: MlDI = chl 〜 16 0 PM = chl 7 〜 24 PCM = ch 25 

: MIDl = chl 〜 16 PCM = chl 7 0 PM = chl 8 〜 25 

: PCM =chl MIDI = ch 2 〜 17 0 PM = chl 8 〜 25 

: PCM =chl 0 PM = ch 2 〜 9 MIDI = chlO 〜 25 

( chi 〜 25 はチャンネル 1 〜チヤンネル25を示します。〉 

(/ Yn ) 

MUSIC PR 0-68 KIM 丨 DI ] で作成された*〜 . MUS ’ ファイルを演奏する場 
合は （/ Y 0> を指定してください。その他の場合は （/ Yl > を指定してく 
ださい。テ••フォルトは </ Yl > に設定されています。 

(/ Pn , filenane ) 

: n = ノート番号 (0 〜127) 

filename で指定された PC M データのファイルを読み込み、 n 番 
のノー ト番号に登録します。ファイル名はフルパス名で指定してく 
ださい。ファイル名はそのまま PCM の音色名として登録されます。 

(/ An , tonename ) 

: n = ノー ト番号 (0 〜127〉 

n 番のノー ト番号に PCM の音色名を登録します。 

(/ S , fi 1 ename ) 

SOUND PR 0-68 K の ’〜 .SNIT ファイル（または （/ SV , f ilenane , で 
作成されたファイル）を読み込み、 FM 音源に登録します。 

ファイル名はフルパス名で指定してください。 

拡張子’ . SND ’ は不要です。 FM 音源の音色名も同時に登録します。 








〜 200) 

〜200〉 

にコビーします。 


1=コビー兀の音色番号 （. 
2=コビー先の音色番号 （ 
M 音源の nl 番の音色を n 2 


:nl = 音色番号 (1 〜200> 

: n 2=^ き換えを始めるパラメータ番号 <0〜54> 

:音色パラメータ （0 〜255〉 

FM 音源の音色を設定します。 

n 2 はバラメータの何番から害き換えるかを示しています 


し n 2, d 1, d 2. • 
•• d 55- n 2> 


: n =0 or 1 

トラックデータを初期化します 。 <M t ， s > も初期化されます 
各トラックバッファは4バイトに設定されます。 
n =0 または省略した場合は音色データを初期化しません。 
n = l で音色データも初期化します。 


=0〜127 ( T フ4卜は 127) 

す。 Un ) を実行するまで有効です. 


ii ) 

メータの内、 LFQ / PMD/AMD 
一夕を音色切り替え時にセットするか 

ジユレーシヨンを正常に機能させる為 
ください。 


は 198) 

(モジュレーション）の変化する速さを設定しま 
ルトに設定されます。 


〜255 
音源の 
(I n ) 


〜200 

音源の音色名を登録します。 


: n = 音色番号 U 〜 200) 

SOUND PR 0-68 K の’〜 . SND •ファイルのフォーマツトで現在登绿され 
ている音色データの内、 n で指定された音色データをファイルに保 
存します。ファイル名はフルパス名で指定してください。 

ファイル名に拡張子’ . SND ’ は不要です。 
n を省略した場台は200音色全てファイルに登録します。 

例） (/ SV , TEST 1, 1-8,20-30, 180-) 

音色番号1〜8,20〜30,180〜200の音色データを TEST 1. SND のファイ 
ル名でファイルに保存します。 


e, 

- n 5) 











n 2) 


MMLdata.• 



25) 



25) 



n 25) 



25) 


25) 


: t = トラック番号 s = バッファサイズ 
トラックバッファを確保します。 
t を省略すると全てのトラックに S を設定します。 

U > でデフォルト（全トラック4バイト〉に設定されます。 

確保したバッファ容策が不足していると、正常に演奏されない場合 
があります。 

( M , T , S > コマンドでエラーが起きた場合は、その時点での確保可能 
な最大値を設定します。 


: c = チャンネル番号 t = トラツク番号 

チャンネル c で演奏するトラツク番号を指定します。 

C が重複した場合は後から指定したチャン:^に設定されます。 
t が重複した場合は複数のチャンネルで同じトラックが演奏されます。 


(20 〜 300) テン ボを設定します 




分子 n 2= 分母 


拍子を設定しま 



ック番号 （1 〜80> 

•ラッ クに MML データを苫き込みます 


: n = チヤンネル番丨〜 25) 

n で指定されたチャンネルの音声出力を許可します。 n で指定された 
チャンネル以外のチャンネルは音声出力が禁止されています。 
(内部的な演奏は継続しています） 
n がすべて省略された場合はすべてのチャンネルの音声出力が許可 
されます。 


: n = チャンネル番号 

n で指定されたチャンネルの演奏を開始します。 
n がすべて省略された場合、全てのチャンネルの演奏を開始します. 


: n = チヤンネル番号 

n で指定されたチャンネルの演奏を停止します。 
n がすべて省略された場合、全てのチャンネルの演奏を停止します. 


: n = チャンネル番号 

n で指定されたチャンネルの演奏を再開します。 
n がすべて省輅された場合、全てのチャンネルの演奏を再開します 


: n = チャンネル番号 

ri で指定されたチャンネルが終了するまで待ちます。 （ ESC キーまた 
は BREAK キーで中止します。〉 

n がすべて省略された場合、全てのチャンネルの演奏が終了するま 
で待ちます。 














0 P M コマンド 

パラメータ / 機 能 

(PM n ) 

:小節番号 

演奏を開始する小節番号を指定します。 

(S W または演奏終了で解除されます。 

(Q nl , n 2> で曲の拍子が設定されていなければ正常な演奏ができま 
せん. 

また、全トラックにおいて、 MML データ， 

D . C . ]”，”[$]” などの数が同じでなければなりません。 

(SM n ) 

: n = 小節番号 

演奏を停止する小節番号を指定します。 

(S n ) または演奏終了で解除されます。 

(Q で曲の拍子が設定されていなければ正常な演奏ができま 

せん. 

また、全トラックにおいて、 MML データ，”1:”，” 

[ D . C . ]”，”[$]” などの数が同じでなければなりません。 

(N c , n ) 

: c =チャンネル番号 （ 1〜25 〉 n = 出カチャンネル番号 （1 〜25〉 

一時的に出カチャンネルを変更します。 

(I n > で元に戻ります。 

(G c , n ) 

: c = チャンネル番号 n = 音色番号 (0 PM :1 〜200 MIDI :1〜128) 

指定のチャンネルに音色番号を設定します。 

(L c , n ) 

: c = チャンネル番号 n = ボリュームデータ<0〜127〉 

指定のチャンネルにボリュームデータを設定します。 

(B c , n ) 

: c = チャンネル番号 n = パンボットデータ<0〜127) 

指定のチャンネルにパンポットデータを設定します。 

(U c , n ) 

: c = チャンネル番号 n = ベロシティデータ <0〜 127) 

指定のチャンネルにベロシティデータを設定します。 

(F c , n ) 

: c = チャンネル番号 n = トランスポーズデータ （0 〜48> 

指定のチャンネルにトランスポーズデータを設定します。 

± 21クタ- r の範囲で半音ずつ音程をシフトします。 （ r フォルトは24> 

(Y c , nl , n 2) 

: c = チャンネル番号 nl = コントロールコード n 2= データ 
指定のチャンネルにコントロールデータを出力します。 

(J c ) 

: c = チャンネル番号 （1 〜25> 

指定のチャンネルへオールノー トオフを出力します 
c を省略した場合は全てのチャンネルにオールノー トオフを出力し 

ます。 1 

... 

(X n 1, n 2,•••• 
n 512) 

■■ ■ 

nl 〜 nm までのデータを M I D I へ直接出力します。 

指定できるデータの数は512個までです。 



: n =0 内部同期 



n = l 外部同期 n =2 FSK 同期 


一 トコード <$ FA > を出力 
ッブコード （$ FC > を出力 
ティニューコード （$ FB > を出力 

コック <$ F 8) を出力しているので、外部シーケンサ 
せることができます。 












13 エラー コードー覧 


_ J 


一番号 


3 3 


テンポの指定が照効です 
トラ ゞ ク番号が無効です 
1 PM !> RV 3 a が登録さわていません 
サイズの楷定が搿効で W 
メモリ -の確保ができま U ん 
デ V ン ネル番号が無効て1 
配列の指定に誤りがあり？す 
3 PMDRV 3. X は現在停止中て V 
ベロシテ.の値がんりません 
ベロ シティの砧が無効です 
鉍迄モードの指定が無効です 
録芦の準_がてきていま 彳イ ん 
バンボットの値がありません 
パン ポットの値が無効 VT 
トランスポーズの値がありません 
トランスポーズの値が無効です 
パラメータを両方省略する求はできま 
パラメータの指定に誤りがあります 
MML の文法に誤りがあります 
[] の中の指定に誤りがあります 
] がありません 
繰り返しの値が無効です 
繰り返し番号の指定がありません 
繰り返し番号の指定が無効です 
オクターブの番号がありません 
オクターブの指定が無効です 
長さの値が無効です 
トラック容 M が足りません 
音色番号の指定がありません 
@ W の値がありません 
@W の値が無効です 
テンポの値がありません 
テンポの値が無効です 
長さの値がありません 
音贵の値がありません 



音 m の値が無効です 
キーコードの値がありません 
キーコードの値が無効です 
音色番号が無効です 
} がありません 
\ ) の中に音符が多すぎます 
< } の中に音符がありません 
u の指定じ沒りがあります 
{} の中の文法に誤りがあります 
丫の指定に誤りがあります 
@ L の指定に誤りがあります 
P の指定に誤りがありま T 
タイの指定に誤りがあります 
和音の指定に誤りがあります 
和音の数が多すぎるか、または後の’がありません 
@ V の指定に誤りがあります 
@ P の指定に誤りがあります 
@ U の指定に誤りがあります 
@ N の指定に誤りがあります 
@ M の指定に誤りがあります 
@ D の指定に誤りがあります 
@ B の指定に誤りがあります 
@ T の指定に誤りがあります 
@ Y の指定に誤りがあります 

PCM のバッファ不足で、これ以上登録できません 
PCM は使用できません 
0 PMDRV 3 .X のバージョンが違います 
無効なサンプリング周波数を指定しました 
無効な出カモードを指定しました 
無効なデータサイズを指定しました 




第 2 章 SCSI 


r C compiler PRO — 68 K v e r 2 .1 J では新たに 
SCSI に対応したライブラリを用意しています。 


これにより、以下のファイルが変更/追加されています。 


ファイル名 

内 容 

ディレクトリ 

I 0 CSLIB.L 

I 0 CS コールライブラリ 

システム2の ¥LIB 

I 0 CSLIB.H 

I OCS コール関数の定義 

システム2の ¥ INCLl)DE 

IOCSCALL.MAC 

IOCS コールのへッダファイル 

システム2の ¥INCLUDE 

SCSI 1 .C 

SCSI サンブル1 

システム2の ¥SAMPLE 

SCSI 2 .C 

SCSI サンプル2 

システム2の SAMPLE 









2.1SCSI サンブルプログラム 


S C S I ライブラリを用いたサンブルブログラムとして、” SCSI 1. C ” および” SCSI 2. C ” が 
システムディスク2の SAMP ILE ディレクトリに入っています。 

1 . SC S I 1 .C 


SCSI コール番号$ 2 0以上の高レベルなライブラリを用いたサンプルブログ 
ラムです 。 SCS I データのグンブ表示や SCS I 装置情報の表示などを行って 
います。 

A>CC /Y SCSM.C 

としてコンパイルしてください。引数に J D のみを指定した（引数が1つの）と 
きは 、 SCS I 装置情報を表示し、ブロック番号も指定したときはそのブロック 
番号のデータを表示します。その後は以下のキー操作をおこなえます。 

ROLLUP , RETURN : 次のブロック番号のデータを表示 

R 0 LLD 0 WUN , UND 0 :前のブロック番号のデータを表示 

ESC :終了 

例 1 )SCS I 装置の I D 番号0の装置情報を表示。 


A > SCSI 1 0 

SCSI Library sample 1 version 1.00 by SHARP 


I D 番号 
最大ブロック数 
ブロックサイズ 

最大容量 
周辺装置機種 

媒体の取外し 
AN S I 規格 


0 

167720 

512バイト 

81 M バイト 

直接アクセス装置 

不可 

合致 


A > 
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例 2) SCS I 装置の I D 番号0、ブロック番号 4 のデータを表示 c 


A > SCSI 1 0 4 

SCSI Library sample 1 version 1.00 by SHARP 

[ ID =0] [ BL 0 CK =4] [MAX BL 0 CK =167719] [BLOCK S 1 ZE =512] [最大容量 =81 Mbyte ] 
BLOCK+n ♦() +1 +2 +3 +4 +5 巧 “ +9 M ♦(： ♦() +E +F ASCII charactor 

00000000 58 36 38 4 B (JO 0140 20 00 01 47 93 00 0147 93 X 68 K ..8 ..G .. G 滴 

npoonoio 48 75 RD 616 E 36 38 63 00 00 00 20 00 00 A 0 00 HumanBSk . 

00000020 48 75 6 D 616 E 36 38 6 B 02 00 A 0 20 00 00 A 0 0 G Human 68 k . 

00000100 9195 92 7. r 3 9153 91 CC 82 PC ' J 7 65 y 7 CA 20 20 装置全体の容最 
00000110 20 20 20 20 20 20 20 20 20 20 38 3120 82 8 C 63 81 M パ 

00000120 6 F 83 43 83 67 00 00 00 98 4191 Bl 8 A . 6 D S 5 DB o イト•••連続確保 

00000130 39 C 2 94 5 C 82 C 8 8 D C 5 91 E 5 97 65 97 CA 20 20 可能な最大容 

U 0000140 20 20 38 3120 82 6 C 83 6 F 33 43 83 67 00 00 00 81 M バイト ... 

〜 产 

000001 F 0 00 00 0 U 0 U 00 00 00 00 00 00 00 00 00 00 00 00 . 

キー入力待ち。 


SC S I 2 . C 


SCSI コール番号 $2 O 未滴の低レベルなライブラリを用いたサンプルブログ 
ラムです。 S _ READ ライブラリと同様に S C S I 装置からデータを読み込み 
ます。 


A>CC /Y SCSI 1 .C SCSI 2 .C 

としてコンパイルしてください。 ’’ SCSI 1. C ” の S_R E A D 関数には、” SCSI 2. C ” 
のブログラムが 、 S C S I ライブラリ内の S_R EA D ライブラリよりも優先し 
て使用されます。 
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• ライブラリー覧 (SCSI コール番号順) 


SCSI 番号 

ライ: r ラリ関数名 

機 能 

PAGE 

$00 

S-RESET 

SPC(SCSI ブロトコルコントローラ〉 
および SCSI バスのリセット 

152 

$01 

S.SELECT 

アービトレーシヨンフェーズと 
セレクシヨンフヱーズの実行 

154 

$03 

S . CMD 0 UT 

コマンドアウトフェーズの実行 

146 

$04 

S.DATAIN 

データインフェーズの実行 

146 

$05 

S . DATA 0 UT 

データアウトフェーズの実行 

147 

$06 

S.STSIN 

ステータスインフヱーズの実行 

155 

$07 

S.MSGIN 

メッセージインフェーズの実行 

148 

$08 

S . MSG 0 UT 

メッセージアウトフェーズの実行 

149 

$09 

S.PHASE 

フェーズセンス 

150 

$20 


I N QU I R Y データの要求 

148 

$21 

S-READ 

SCSI 装8?よりデータの読み込み 

150 

$22 

S.WRITE 

SCSI 装置へのデータの害き込み 

156 

$23 

S . F 0 RMAT 

SCS I 装 ( S のフォーマット 

147 

$24 

S.TESTUNIT 

SCSI 装 S が動作可能であるか 
どうかの調査 

156 

$25 

S.READCAP 

SCSI 装! S の容最に関する情報 
の調査 

151 

$26 

S.READEXT 

拡張 READ コマンド 

151 

$27 

S.WRITEEXT 

拡張 WR I T E コマンド 

157 

$2 b 

S . REZER 0 UNIT 

SCSI 装置を指定の状態にセット 

153 

$2 c 

S.REQUEST 

SCS I 装置のセンスデータの調査 

153 

$2 d 

S.SEEK 

指定の論理ブロックァドレスへの 
シーク 

154 

$2 f 

S . STARTST 0 P 

SCS I 装置に対して以降の操作 
の可能/不可能の要求 

155 

$31 

S.REASSIGN 

欠陥ブロックの割り当ての要求 

152 

$32 

S.PAMEDIUM 

泛 gx アのイジヱクトの禁止 • 許可 

149 


144 














「 2_ 4 ライブラリリファレンス 


rc compiler PR 0-68 K v e r 2.1 J では 、 SCSI ドライバに 
対応したライブラリがサボートされています。 

これにより、新しく次のファイルが v e r 2. 1より追加/変更されています。 


ファイル名 

内 容 

I 0 CSLIB.L 

I 0 CSLIB.H 

IOCSCALL.MAC 

I OCS コールライブラリ 

I OCS コール関数の定 

IOCS コールのへツダフアイル 
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S—CMDOUT - ^ 


書式 #include <iocs1ib.h > 


int S_CMDOUT(BYTE,CDBADDR )； 
int BYTE ； 

unsigned char *CDBADDR ； 


/* コマンドのバイト数*/ 
/* CDB の先頭アドレス*/ 


機 能]コマンドフェーズを実行します。 

CDB (Command Di script or Block 〉 の先頭アドレスからそのコマンドのバ 
イト数分のデータを SCS I バス上に出力します。 

グルーブ0/1/5以外のコマンドのときは、 BYTE にコマンドのバイト数を 
指定してください。 



エラーコードを返します。（エラーコード参照) 


S - DATAIN -^ 


窖式 


#include < iocs 丨 ib.h> 


int S.DATAIN(BYTE,ADDRESS )； 
int BYTE ； 

unsigned char *ADDRESS ； 


/* 読み込みバイト数*/ 

/* 読み込み先頭アドレス*/ 


機能 j データインフェーズを実行します。 

ADDRESS で指定したアドレスへ BYTE で指定したバイト数分のデータを S 
C S I バス上から読み込みます。 


エラーコードを返します。（エラーコード参照) 
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# include < iocs 1 ib . h > 
int S.DATAOUT ( BYTE , ADDRESS )； 

int BYTE ； /* 書き込みバイト数*/ 

unsigned char ♦ ADDRESS ； /* 書き込み先頭アドレス*/ 

機 能 j データアウトフェーズを実行します。 

ADDRESS で指定したアドレスから BYTE で指定したバイト数分のデータを 
SCSI バス上へ害き込みます。 

エラーコードを返します。（エラーコード#照） 




厂 S FORMAT 

r - _ 

畜 式 #include < iocs 1 ib . h > 

int S . FORMAT ( INTERL , ID )； 

int INTERL ； /* インターリーブ*/ 

int ID ； /* ターゲット I D */ 




指定のインターリーブ値で SCS I 装置をフォーマツトします。 



ステータスを返します。 
一 1なら異常終了 


(上位=メッセージインフェーズで得た情報 
/下位=ステータスインフェーズで得た情報) 
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S.INQUIRY 


レベル 0 


書式 .include < iocs 1 ib . h > 


int S . INQUIRY ( BYTE , ID , inq )； 
int BYTE ； 
int ID ； 

struct INQUIRY * inq ； 


/* 読み込みバイト数*/ 

/* ターゲツトの I D */ 

/* 読み込み先頭アドレス*/ 


機能 inq で示すアドレスに BYTE で指定したバイトの INQUIRY データを読み込み 


ます。 






struct 

INQUIRY { 





uns 

gned 

char 

unit ; 

/* 周辺装置機種*/ 


uns 

gned 

char 

info ； 

/* RMB | 機種限定*/ 


uns 

gned 

char 

ver ； 

/♦ISOIECMAIANSI バージョン */ 


uns 

gned 

char 

reserve ! 

/* 保留*/ 


uns 

gned 

char 

size ； 

/* 追加長*/ 


uns 

gned 

char 

buff []; 

/* ベンダーユニーク*/ 


>; 


戻り値1 ステータスを返します。（上位=メッセージインフェーズで得た情報 

/下位=ステータスインフヱーズで得た情報) 

一1なら異常終了 


S MSGIN 


レベル0 


者 式 #include < iocs 1 ib . h > 


int S . MSGIN ( ADDRESS )； 

unsigned char * ADDRESS ; /* 読み込み先頭アドレス*/ 


機 m \ メッセージインフェーズを実行します。 

ADDRESS で指定したアドレスへ1バイトのデータを S C S I バス上から 
読み込みます。 


戻り値| エラーコードを返します。（エラーコード参照) 
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S—MSGOUT _ 

ー レペル 0 


害 式 ttinclude < iocsIib . h > 


int S . MSGOUT ( ADDRESS )； 

unsigned char * ADDRESS ; /* 読み込み先頭アドレス*/ 


機 能 j メッセージアウトフェーズを実行します。 

ADDRESS で指定したアドレスから1バイトのデータを S C S I バス上へ 
書き込みます。 


戻り値 エラーコードを返します。（エラーコード参照) 


S PAMEDIUM 


レベル0 


苦 式 #include < iocs 1 ib . h > 


int S _ PAMEDIUM ( MODE , ID )； 

int MODE ； /*0 : イジ ヱクト許可/ 1 : イジ ヱクト禁止*/ 

int ID ； /* ターゲッ トの I D*/ 


機 _ メディアのイジヱクトの禁止/許可を設定します。 MODE が0のとき 

イジェクト許可、1のときイジ x クト禁止に設定します。 


戻り値| ステータスを返します。（上位=メッセージインフェーズで得た情報 

/下位= ステータス イ ンフヱーズで 得た情報) 

一 1なら異常終了 
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s — PHASE - ^ 


書式 #include < iocs 1ib-h> 


int S.PHASE(void )； 


[ 機 _ 能]フェーズをセンスします。 

SPC の PSNS レジスタを読みだします。 


戻り 値； 現在のフェーズを返します。 


S - READ -^ 



# include < iocs Iib.h> 

int S-READ(P0S,BLOCK,ID,SIZE,ADDRESS )； 

int POS ； /* 目的読み込み位 K (論理ブロック番号）*/ 

int BLOCK ； /* 読み込みブロック数（論理ブロック数）*/ 

int ID ： /* ターゲットの I D*/ 

int SIZE ； /* 1 ブロ ックの容 纘 (0=256/1=512/2=1024) ♦/ 

unsigned char *ADDRESSi 

/* 読み込み先頭アドレス*/ 


機 能」 P0S で指定した論理ブロック番号から BLOCK で指定したブロック分のデー 

夕を ADDRESS で指定したアドレスへ読み込みます。 

1ブロックの容量は3以上を指定できません。 


戻り値1 ステータスを返します。（上位=メッセージインフェーズで得た情報 

/下位ニステータスイ ンフヱーズで得た情報) 

一1, 一2なら異常終了 
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S READCAP 


レベル 0 


書 式 # include <iocslib.h> 


int S_READCAP(ID ， capa); 
int ID ； 

struct READCAP *capa 


/* ターゲット I D*/ 

/* 読み込み先頭アドレス*/ 


機能 capa で示すアドレスに 8 バイトの READ CAPACITY データを読み込みます。 


struct READCAPA { 

unsigned int block ； 
unsigned int size; 

>； 


/* 論理ブロックアドレス*/ 
/* ブロック長*/ 



ステータスを返します。 
一1なら異常終了 


(上位=メッセージインフヱーズで得た情報 
/下位=ステータスインフェーズで得た情報) 


S 一 READEXT _ 

レペル0 


畜式 # include < iocsIib.h > 


int S.READEXKPOS, BLOCK, ID, SIZE, ADDRESS )； 
int POS ； ノ♦目的読み込み位置（論理ブロック番号）*/ 

int BLOCK ； /* 読み込みブロック数（論理ブロック数）*/ 

int ID ； /* ターゲットの I D*/ 

int SIZE ； /*1 ブロックの容量 (0=256/1=512/2=1024 ) */ 

unsigned char ♦ADDRESS ； 

/* 読み込み先頭アドレス*/ 


機 能| P0S で指定した論理ブロック番号から BLOCK で指定したブロック分のデ ー 

夕を ADDRESS で指定したアドレスへ読み込みます。 

グルーブ 1 のコマンド。 

読み込みブロック長は 65,535 ブロックまで指定可能。 

1ブロックの容量は3以上を指定できません。 


戻り値| ステータスを返します。（上位=メッセージインフェーズで得た情報 

/下位=ステータスインフヱーズで得た情報) 

一 1, 一2なら異常終了 
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S REASSIGN 


レベル 0 


書 式 # include < iocslib . h > 


int S . REASSIGN ( BYTE , ID , ADDRESS )； 

int BYTE ； /* 書き込みバイト数*/ 

int ID ； /* ターゲットの I D */ 

unsigned char ^ ADDRESS ； /* 害き込み先頭アドレス*/ 


機 能」 欠陥ブロックの再割り当てを要求します。 ADDRESS で指定したアド 

レスから BYTE で指定したバイト数の REASSIGN BLOCKS データを窨き込み 

ます。 


戻り値 ステータスを返します。（上位=メッセージインフェーズで得た情報 

/下位=ステータスインフヱーズで得た情報) 

一 1なら異常終了 


S - RESET -^ 


m _式 


Sinclude < iocslib . h > 


void S - RESET ( void )； 


機 _ m ] s pc (scs i ブロトコルコントローラ）の初期化、 scsi バスの 

リセットを行います。 

SCS I バスリセット後に2秒間待機します。 


戻り値| 戻り値はありません。 
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S.REQUEST 


レベル 0 


害 式 #include く iocslib . h > 


int S . REQUESKBYTE , ID , ADDRESS )； 

int BYTE ； /* 読み込みバイト数*/ 

int ID ； /* ターゲットの I D */ 

unsigned char + ADDRESS ； /* 読み込み先頭アドレス*/ 


機能 ADDRESS で指定したアドレスへ BYTE で指定したバイト数の REQUEST 

SENSE データ （SCS I 装置のセンスデータ）を読み込みます。 


戻り値 


ステータスを返します。 
一1なら異常終了 


(上位=メッセージインフヱーズで得た情報 
/下位=ステータスインフヱーズで得た情報) 


S REZEROUNIT 


レベル〇 


害_式 


Sine Iude < iocsIib.h > 


int S . REZEROUNIT ( ID )； 
int ID ； 


/* ターゲットの I D */ 


機能 ] SCS I 装®を指定の状態にセツトすることを要求します。 

指定の状態は各装置の取扱説明書を参照してください。 


戻り値| ステータスを返します。（上位=メッセージインフェーズで得た情報 

/下位=ステータスインフヱーズで得た情報) 

一 1なら異常終了 
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S SEEK 


レベル 0 


L 書 式 


8 inc lude <i ocsI ib . h> 


int S . SEEK ( P 0 S , ID )； 

int POS ; /* 目的シー-ク位置（論理ブロック番号）*/ 

int ID ； /* ターゲットの I D */ 


機 能 1 P 0 S で指定した論理ブロック番号にシークします。 


戻り値1 ステータスを返します。（上位= メッセー ジインフ ヱーズ て得た情報 

/下位=ステ-タスインフェーズで冴た情報) 

一 1なら異常終了 


S—SELECT -^ 


3? 式 ttinc lude < iocs I ib . h > 


int S . SELECT ( ID )； 

int ID ； /* ターゲット I D */ 


機 能 アービトレーションフェーズとセレクションフェーズを実行します。 


戻り値 エラーコードを返します。（エラーコードの参照) 
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S—STARTSTOP - ^ 


; 害 式 


林 include く iocs 丨 ib.h > 


int S.STARTSTOP(MODE, ID )； 
int MODE ； 
int ID ； 


/*〇:操作不可/ 1: 操作可*/ 
/* ター ゲッ トの I D*/ 


機 能 SCS I 装置に対して以降の操作を可能、または操作を不可能にするこ 

とを要求します。 

MODE が 1 のときは SCS I 装置を操作できるように設定し、また 0 のと 
きは SCS I 装置を停止（操作不可）するように要求します。 


戻り値 j ステータスを返します。（上位=メッセージインフェーズで得た情報 

/下位=ステータスインフヱーズで得た情報) 

一1なら異常終了 


S STSIN 


書 式 #include < iocslib.h> 


int S.STSIN(ADDRESS )； 

unsigned char ♦ADDRESS ； /* 読み込み先頭アドレス*/ 


機 ^] ステータス イン フェーズを 実行します。 

ADDRESS で指定したアドレスへ 1 バイトのデータを S C S I バス上 
から読み込みます。 



エラーコー ドを返します。 （エラーコー ドの参照) 
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S TESTUNIT 


レベル 0 


書 式 ^include < i ocs 1 ib . h > 


int S . TESTUNIT ( ID )； 

int ID ； /* ターゲット I D */ 

機 能 1 SCSI 装 g が動作可能であるかを調べます。戻り値が NULL のときにのみ 

動作可能です。 


戻り値 ステータスを返します。（上位ニメッセージインフェーズで得た情報 

/下位= ステータス イ ンフヱーズで 得た情報) 

一1なら異常終了 


S - WRITE - 


害 式 


# include < iocs 1 ib . h > 


int S . WRITE ( POS , BLOCK , 丨 D , SIZE , ADDRESS ); 

int POS ； /* 目的害き込み位置（論理ブロック番号）*/ 

int BLOCK ； /*S き込みブロック数（論理ブロック数）*/ 

int ID ; /* ターゲットの I D */ 

int SIZE ； /♦1 ブロ ックの容最 （0=256/1=512/2=1024 ) */ 

unsigned char * ADDRESS ; 

/* 害き込み先頭アドレス*/ 


機 龍] P 0 S で指定した論理ブロック番号から BLOCK で指定したブロック分のデー 

夕を ADDRESS で指定したアドレスから害き込みます。 

1ブロックの容最は3以上を指定できません。 


戻り値 ステータスを返します。（上位=メッセージインフェーズで得た情報 

/下位ニステータスイ ンフヱーズで 得た情報) 

一1, 一2なら異常終了 
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S_WRITEEXT - 

レべ•ル 0 



林 inc lude < iocs 1 ib . h > 


int S.«RITEEXT(POS,BLOCK,ID,SIZE,ADDRESS )； 
int POS ； /* 目的害き込み位置（論理ブロック番号）*/ 

int BLOCK ； /* 書き込みブロック数（論理ブロック数）*/ 

int ID ； /* ターゲットの I D*/ 

int SIZE ； /* 1ブロ ックの容量 （0=256/1=512/2=1024) */ 

unsigned char *ADDRESS ； 

/* 書き込み先頭アドレス*/ 


機 能] P 0 S で指定した論理ブロック番号から BLOCK で指定したブロック分のデー 

夕を ADDRESS で指定したアドレスへ書き込みます。 

グルーブ 1 のコマンド。 

書き込みブロック長は65,535ブロックまで指定可能。 

1ブロックの容置は3以上を指定できません。 


戻り値 I ステータスを返します。（上位=メッセージインフェーズで得た情報 

/下位=ステータスインフェーズで得た情報) 

一1, 一2なら異常終了 
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2. 4 SCSI IOCS-1 


9 I 0 C S —覧（アルファベット頗) 


SCSI 番号 

I0CS34 名 

機 能 

PAGE 

$03 

- 1 

S.CkDOUT | 

I 

コマンド アウ トフューズの実行 

161 

$04 

S-DATAIN j 

••/ 一 5 i :- y x ーズの実行 

161 

m 1 

S 』 A!，_T ! 

データアウトフェーズの実行 

162 

$23 

S.FGRMAT ! 

SCSI 劳稗のソォーマット 

166 

$20 

SJf)QU!；<V 

1 N T Q U r データの要求 

164 

$07 

S.MSGIN 

メ 、•，セージインフ X — ズの実行 

163 

$08 

S.MSGOUT 

メッセージアウト フェーズの 実行 

163 

$32 

S.PAMEDIUM 

メディアのイジ X クトの禁止 • 許可 
の設定 

171 

$09 

S.PHASE 

フェーズセンス 

164 

$21 

S.READ 

SCS I 装置よりデータの読み込み 

165 

$25 

S.READCAP 

SCSI 装置の容量に関する情報 
の調査 

167 

$26 

S.READEXT 

拡張 READ コマンド 

167 

$31 

S.REASSIGN 

欠陥ブロックの割り当ての要求 

170 

$00 

S.RESET 

SPC<SCSI ブロトコルコントローラ） 
および SCSI バスのリセット 

160 

$2c 

S.REQUEST 

SCSI 装置のセンスデータの調査 

169 

$2b 

S-REZEROUNIT 

SCSI 装置を指定の状態にセット 

168 

$2d 

S.SEEK 

指定の論理ブロックアドレスへの 
シーク 

169 

$01 

S.SELECT 

アービトレーションフェーズと 
セレクションフェーズの実行 

160 

$2f 

S.STARTSTOP 

SCSI 装置に対して以降の操作 
の可能/不可能の要求 

170 

$06 

S-STSIN 

ステータスインフェーズの実行 

162 

$24 

S.TESTUNIT 

SCSI 装置が動作可能であるか 
どうかの調査 

166 

$22 

S.BRITE 

SCSI 装置へのデータの害き込み 

165 


$27 


ffRITEEXT 


拡張 WR I T E コマンド 
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5 IOCS コールリファレンス 

「C compiler PRO-G 8 K v e r 2 . i J では 、 SCSI ドライバに 
により、次の様にして I OCS コールを利用する:：とができます。 

moveq. 1 #SCSI コール S 号， D1 
m 〇 v e q . 1 # $ F 5, DO 

trap #15 

(SCSI の IOCS コール番号は全て $ F 5 てす。、 

例 ） S PC ヴ、リセ.ソトお よび SCS I バス グリ セット 

moveq.I #SCU,D1 
rauven. I i)U 

trap #15 

またはマクロを使用して 
include iocscal1.mac 



raoveq.I #_ S_RESET 

!0CS .SCSI DRV 

IOC S コールの 詳細説明は、「ブロ グラマー ズ マニュアル 第 3 章 I 0 C S コール」 
を参照してください。 
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S RESET 


• S.RESET I OC S コール番号 ： $ F 5 SCSI コール番号 ： $ 0 0 

SPC ( SCSI ブロコトルコントローラ）のリセットおよび SCS 
I バスリセット 



入力 



DO . L $ F 5 IOC S コール番号 

D 1 .L $00 S C S I コール番 v 

なし （ DO . L は内容が保証されません） 


SPC の初期化 、 SCS I バスのリセットを行います。 
SCS I バスリセツト後に2秒間待機します。 


S SELECT 


#S SELECT I OC S コール 番号 ： $ F 5 SCSI コール 番号 ： $ 01 



リターン 


アービトレーションフェーズとセレクションフェーズの実行 


DO . L 

$ F 5 

IOCS コール番号 

Dl.L 

$01 

• SCSI コール番号 

D 4. L 

ター 

ゲットの I D 

DO . L 

エラ 

ーコード <0以外なら異常終了) 


解 説1 アービトレーションフェーズとセレクションフェーズを実行します。 
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S CMDOUT 


• S.CMDOUT I OC S コール 番号： $ F 5 S C S I コール 番号： $ 0 3 


機 

能 


入 

力 


リターン 


コマンドアウトフェーズの実行 

DO . L $ F 5 IOC S コール番号 

Dl.L $03 SCSI コール番号 

D 3. L コマンドのバイト数（グルーブ0/1/5以外のとき） 

Al.L CDB (COMMAND DISCRIPTOR 

BLOCK ) の先頭アドレス 

DO . L エラーコード 


|解 説]コマンドフヱーズを実行します。 

Al . L のアドレスからそのコマンドのバイト数分のデータを S C S I 
バス上に出力します。 

グルーブ〇/丨/5以外のコマンドのときは D 3. L にバイト数を指定してく 
ださい。 

リターンの DO . L のエラーコードについては、エラーコード表を参照 
してください。 


S DATAIN 


S DATAIN 


OCS コール 番号：$ F 5 SCSI コール 番号：$04 




能 


データインフヱーズの実行 


入力 


リターン 


DO . L 

$ F 5 

10 

C S コー 

DLL 

$04 

S C 

S I コー 

D 3. L 

読み込みバイ 

卜数 

Al.L 

読み込み先頭ァドレス 

DO . L 

エラー 

コード 



解説 


データインフェーズを実行します。 

Al . L のアドレスへ D 3. L バイトのデータを SCS I から読み込みま 
す0 


リターンの DO . L のエラーコードについては、エラーコード表を参照 
してください。 
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S DATAOUT 


❼ S.DATAOUT I OC S コール番号 ： $ F 5 SCSI コー/レ番号 ： $ 0 5 
r m l データアウトフ ヱ ーズの実行 




DO. L $F5 IOCS コール番号 

Dl.L $05 SCSI コール番号 

D3. L 畜き込みバイト数 

Al.L 畜き込み先頭アドレス 

DO. L エラーコード 

データアウトフェースを実行します。 

Al. L のアドレスから D3. L バイトのデータを S C S I へ書き込みま 
す 0 

リターンの DO. L の エラーコー ドについては、 エラーコー ド表を参照 
してください。 


S STSIN 


• S.STSIN I OC S コール 番号 ：$ F 5 SCSI コール 番号 ：$ 0 6 

m 能]ステータスインフェーズの実行 


入 力 DO. L 

D1.L 
Al.L 


$F5 IOCS コール番号 
$06 SCSI コール番号 

読み込み先頭アドレス 


リターン DO. L 


エラーコード 


m ^_] ステータスインフェーズを実行します。 

Al.L のアドレスへ 1 バイトのデータを SCS I バスから読み込みま 
す 0 

リターンの DO. L のエラーコードについては、エラーコード表を参照 
してください。 
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S MSGIN 


• S.MSGIN I OC S コール番号 ： $ F 5 SCSI コール番号 ： $ 0 7 


機 

能 


入 

力 


メッセージインフェーズの実行 

DO . L $ F 5 IOC S コール番号 

Dl.L $07 SCSI コール番号 

Al.L 読み込み先頭アドレス 



DO . L エラーコード 

メッセージインフェーズを実行します0 

Al . L のアドレスへ1バイトのデータを S C S I バス上から読み込み 
ます。 

リターンの DO . L のエラーコードについては、エラーコード表を参照 
してください。 


S MSG0UT 


• S.MSGOUT I OCS コール 番号 ： $ F 5 SCSI コール 番号 ： $0 8 


機 

能 


入 

力 


リターン 


メッセージアウトフェーズの実行 

DO . L $ F 5 IOC S コール番号 

Dl.L $08 SCSI コール番号 

Al.L 書き込み先頭アドレス 

DO . L エラーコード 


I 解一説」 メッセージアウトフェーズを実行します。 

Al . L のアドレスから1バイトのデータを S C S I パス上へ軎き込み 
ます。 

リターンの DO . L のエラーコードについては、エラーコード表を参照 
してください。 
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コール 番号 
コール 番号 


$ F 5 

$09 


の PSNS レジスタ（エラーコード表を参照）を読みだします。 


現在のフェーズ 


ズセンス 


S PHASE 


• S—PHASE I OC S コール 番号 ： $ F 5 SCSI コール 番号 ： $ 0 9 


機 

能 


入 

力 


リタ 

ーン 


解 

説 


フエー 

DO . L 
DLL 

DO . L 
S P C 


S INQUIRY 


S_INQUIRY 


OCS コール番号： $ F 5 SCSI コール番号： $ 2 0 


機 

能 


入 

力 


リターン 


解 説 


I N QU I RY データの要求 

DO . L $ F 5 IOC S コール番号 

Dl.L $20 SCSI コール番号 

D 3. L 読み込みバイト数 

D 4. L ターゲットの I D 

Al.L 読み込み先頭アドレス 

DO . L ステータス（上位==メッセージインフェーズで得た 

情報/下位=ステータスインフェーズで 
得た情報） 

一 1なら異常終了 

Al . L のアドレスへ D 3. L バイトの I N QU I R Y データを読み込み 
ます。 


S I 

c S 
O C 
I S 
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$ F 5 IOC S コール 番号 

$21 SCSI コール 番号 

目的読み込み位置（物理ブロック番号） 
読み込みブロック数（論理ブロック数） 
ターゲツトの I D 

1ブロ ツクの容置 (0=256/1=512/2=1024) 
読み込み先頭アドレス 


解 説 


D 2. L の論理ブロック番号から D 3. L ブロック分のデータを A 1. しの 
アト、スへ読み込みます。1ブロックの容缳は3以上を指定できません。 


S WRITE 


S.WRITE 


能 


OC S コール 番号：$ F 5 SCSI コール 番号：$ 2 2 
SCS I 装置へのデータの書き込み 


入 力 


リターン 


DO . L 
D 1 
D 2. L 
D 3 
D 4 
D 5 
ALL 

DO . L 


$ F 5 IOC S コール番号 

$22 SCSI コール番号 

目的害き込み位 ■ (論理ブロック番号） 

害き込みブロック数（論理ブロック数） 

ターゲットの I D 

1ブロックの容置 (0=256 ハ =512/2=1024) 

窨き込み先頭アドレス 

ステータス（上位=メッセージインフェーズで得た情 

報/下位=ステータスインフェーズで得 
た情報） 

一 1 , 一2なら異常終了 


解 説 


D 2. L の論理ブロック番号から D 3. L ブロック分のデータを A 1. しの 
アドレスから書き込みます。 

1ブロックの容置は3以上を指定できません。 


D 0 


L 


ステータス（上位=メッセージインフェーズで得た悄 

報/下位=ステータスインフェーズで得 

た情報） 

一 1 , 一2なら異常終了 


SCSI 装置よりデータの読み込み 


I OC S コール 番号 ： $ F 5 SCSI コール 番号 ： $ 21 


• SPREAD 


機 

能 


入 

力 


リターン 



S RRAn 


0 1 2 3 4 5 1 
D D D D D D A 
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S FORMAT 


• S_FORMAT I OCS コール番号 ： $F 5 SCSI コール番号： $23 
I 機 能 1 SCSi 装置のフォーマット 


入 力 I DO . L 

Dl.L 
D 3. L 
D 4. L 


$ F 5 10 C S コール番号 

$23 SCSI コール番号 

インターリーブ 
ターゲットの I D 


リターン DO . L ステータス（上位=メッセージインフェーズで得た情 

報/下位=ステータスインフェーズで得 
た情報） 

一1なら異常終了 


解 説 指定のインターリーブ値で SCS I 装 fg をフォーマツトします。 


S TESTUNIT 



• S TESTUNIT I OCS コール番号：$ F 5 SCSI コール番号 •• $ 2 4 



SCSI 装！ S が動作可能であるかどうかを調べる。 

DO . L $ F 5 IOCS コール番号 

Dl.L $24 SCSI コール番号 

D 4. L ターゲットの I D 


リターン DO . L ステータス（上位=メッセージインフェーズで得た 

情報/下位=ステータスインフェーズで 
得た情報） 

一 1なら異常終了 


解説 S C S I 装骹が動作可能であるかどうかを調べる。リターンの DO . L 

が0のみ動作可能です。 
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S READCAP 


• S.READCAP I OC S コール 番号: $ F ^ SCSI コール 番号 ： $ 2 5 


機 

能 

SCSI の容*に関する情報を調べる。 

入 

力 

DO . L 

$ F 5 IOC S コール番号 



Dl.L 

$25 SCSI コール番号 



D 4. L 

ターゲットの I D 



ALL 

読み込み先頭アドレス 

リターン 

DO . L 

ステータス（上位=メッセージインフェーズで得た情 




報/下位=ステータスイ ンフェーズで得 

た情報） 




一 1なら異常終了 

解 

説 

Al.L のアドレスへ 4 ワードの READ CAPACITY データを読 


み込みます。 


S READEXT 


• S.READEXT I OC S コール 番号 ： $ F 5 SCSI コール 番号 ： $ 2 6 


機 

能 


入 

力 


リターン 


拡張 READ コマンド 

DO. L $F5 IOC S コール番号 

Dl.L $26 SCSI コール番号 

D2. L 目的読み込み位置（論理ブロック番号） 

D3. L 読み込みブロック数（物理セクタ数） 

D4. L ターゲットの I D 

D5. L 1 ブロ ックの容最 (0=256 ハ =512/2=1024) 

Al.L 読み込み先頭アドレス 

DO. L ステータス（上位=メッセージインフェーズで得た情 

報/下位=ステータスインフェーズで得 
た情報） 

一 1 , 一2なら異常終了 


解 説 


グルーブ 1 のコマンド。読み込みブロック長は 65,535 ブロツクまで 
指定可能。 D2. L の論理ブロック番号から D3. L ブロック分のデータ 
を Al . L のアドレスへ読み込みます。 

1 ブロックの容置は 3 以上を指定できません。 
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S WRITEEXT 


• S.BRITEEXT IOC S コール番号： $ F 5 SCSI コール番号： $ 2 7 


m 

能 


入 

力 


リターン 


拡張 WR I T E コマンド 

DO . L $ F 5 IOC S コール番号 

Dl.L $27 SCSI コール番号 

D 2. L 目的書き込み位置（論理ブロック番号） 

D 3. L 害き込みブロック数（論理ブロック数） 

D 4. L ターゲットの I D 

D 5. L 1ブロ ックの容最 (0=256 ハ=512/2二1024) 

Al.L 窖き込み先頭アドレス 

DO . L ステータス（上位=メッセージインフェーズで得た情 

報/下位=ステータスインフェーズで得 

た情報） 

一1, 一2なら異常終了 


I 解 説 グルーブ1のコマンド。窨き込みブロック長は65,535まで指定可能。 

D 2. L の論理ブロック番号から D 3. L ブロック分のデータを A 1. しの 
7 ドレスへ害き込みます。 

1ブロックの容墩は3以上を指定できません。 


S REZEROUNIT 


• S REZEROUNIT I OC S コール番号：$ F 5 SCSI コール番号：$ 2 B 


機 

能 

SCSI 装置を指定の状態にセット 

入 

力 

DO . L $ F 5 IOCS コール番号 

Dl.L $2 B SCSI コール番号 

D 4. L ターゲットの I D 

リタ 

—ン 

DO . L ステータス（上位=メッセージインフェーズで得た情 

報/下位ニステータスインフェーズで得 
た情報） 

一 1なら異常終了 

解 

説 

SCS I 装置を指定の状態にセットすることを要求します。 

指定の状態は各装置の取扱説明書を参照してください。 
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S.REQUEST 


• S.REQUEST I OCS コール番号 ： $F 5 SCSI コール番号： $ 2 C 


機 

能 


入 

力 


リターン 


解説 


SCSI 装置のセンスデータを調べる 


DO . L $ F 5 IOC S コール番号 

Dl.L $2 C SCSI コール番号 

D 3. L 読み込みバイト数 

D 4. L ターゲットの I D 

Al.L 読み込み先頭アドレス 

DO . L ステータス（上位=メッセージインフェーズで得た情 

報/下位=ステータスインフェーズで得 
た情報） 

一 1なら異常終了 

Al . L のアドレスへ D 3. L のバイト数分の REQUEST SENS 
E データ （SCS I 装 K のセンスデータ）を読み込みます。 


S SEEK 


• S.SEEK I OC S コール番号：$ F 5 SCSI コール番号：$ 2 D 
W 能 指定の論理ブロックアドレスへシークする 


入力 


リターン 



DO . L $ F 5 IOC S コール番号 

Dl.L $2 D SCSI コール番号 

D 2. L 目的シーク位置 (論理ブロック番号） 

D 4. L ターゲットの I D 

D0 * L ステータス（上位=メッセージインフェーズで得た情 

報/下位=ステータスイ ンフェーズで得 

た情報） 

一 1なら異常終了 

D 2. L の論理ブロック番号にシークします。 
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S STARTSTOP 


S.STARTSTOP I OC S コール 番号 ：$F 5 SCSI コール 番号 ： $ 2 F 


機能—: 


SCS I 装置に対して以降の操作を可能、または操作を不可能にする 
ことを要求 I . ます。 



$ F 5 I OCS コー/レ番号 

$2F SCSI コール番号 

操作可/不可〇操作不可 

1操作可 

ターゲットの J D 



DO \ ステータス（上位コ乂ッセーシインフェーズで得た情 

報/下位=ステータスインフヱ ー ズで得 

た情報> 

一1なら異常終了 



入力のの D 3. L が1のときは SC S I 装餐を操作できるように設定し 
また0のときは SCS I 装餺を停止（操作不可）するように要求します。 


S REASSIGN 


• S REASSIGN I OC S コール 番号 ：$F 5 SCSI コール 番号 ：$ 31 



リターン 


REASSIGN BLOCKS 

DO . L $ F 5 IOCS コール番号 

Dl.L $31 SCSI コール番号 

D 3. L 害き込みバイト数 

D 4. L ターゲットの I D 

Al.L 書き込み先頭アドレス 

DO . L ステータス（上位ニメッセージインフェーズで得た情 

報/下位=ステータスインフェーズで得 

た情報） 

一1なら異常終了 


解説」 欠陥ブロックの再割り当てを要求します。 

Al.L から D 3. L のバイト数分の REASSIGN BLOK S データ 

を書き込みます。 
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S PAMEDIUM 



❿ S.PAHEDIUM I OC S コール番号 ： $ F 5 SCSI コール番号 ： $ 3 2 



メディアのイジェクトの禁止 • 許可を設定 


DO . L 

$ F 5 

IOCS 〕 

DLL 

$3? 

S C S I っ 

D 3. L 

イジ 

ェクト許可/ イ 

D 4. L 

ター 

ゲットの T D 


ール番号 
ール番号 

ジエクト禁止0イジュクト許可 

1イジヱクト禁止 




DO . 


ステータス f i: 位=メッセージインフェーズで得た 情 

嘈 /7 •ソ $ =ステータス イ ンフヱ ーズで得 
た惝輅 j 

一 1 なら異常終了 



メディアのイジ！•クト禁止/許口了を設定します。入力の D 3. L が 0 の 
ときイジェクト許可、1のときイジェクト禁止に設定します。 
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2. 61 ラーコード 


S ( SPC の割り込み原因) 


D 22 D 21 D 20 D 19 D 18 D 17 D 16 



L RESET コンディシヨン 割り込み 

—— S PC ハードウエア割り込み 

-セレクシ ヨン タイムアウト割り込み 

一実行しようとする転送フェーズと SCS I 上で要求 
されている転送フヱーズとが 不一致、 あるいは耘送 
実行中に他の転送フューズが要求されたときの割り 
込み 

—— SPC に対する コマン ドの動作の終了割り込み 

- D I SCONNECTED 割り込み 

- RESELECTED 割り込み 

- SELECTED 割り込み 

各ビットは〇 . 割り込み無し 

1 . 割り込み有り 


下位 = P SNS(SCS I バス上の制御信号の状態) 


PSNS 




ACK 


SEL 

BSY 

MSG 




各 














逆 K —：% 棟式会対 

本 社〒545大阪市阿倍野区長池町22番22号 

電子機 ffi 事業本部亍 329-21 栃木県矢板市早川町174番地 

AVC システム事業推 fi 室 

お問い合わせ先〒162榮京 S 新宿区市谷八幡町8番地電話 （03)3260-1161( 大代表） 

東京支社内電子《«事業本部 AVC システム寧業推進室ソフトウェア担当 




